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I Third Edition (September 1986) 

I This edition applies to Version 2.1 PTF 1 of the Licensed Program IBM Series/ 1 Event 
Driven Executive Communications Facility, Program Number 5719-CF2, and to all 
subsequent versions and modifications of this program unless otherwise indicated in new 
editions or technical newsletters. 

Information in this publication is subject to significant change. Any such changes will be 
reported in new editions or technical newsletters. Use this publication only for the 
purposes mentioned under "About This Book" on page v. 

It is possible that this material may contain references to, or information about, IBM 
products (machines and programs), programming, or services that are not announced in 
your country. Such references or information must not be construed to mean that IBM 
intends to announce such IBM products, programming, or services in your country. 

Direct all requests for copies of IBM publications to your IBM representative or to the 
IBM branch office that serves your locality. 

Any names of individuals, companies, brands, and products in the examples in this book 
are fictitious; any similarity to the name of an actual business enterprise is entirely 
coincidental. 

This publication may contain technical or typographical errors. Forms for readers' 
comments are provided at the back of the book. If the forms have been removed, address 
your comments to IBM Corporation, System Products Division, 4J1/037, PASS MS33, 
PO Box 10500, Palo Alto, CA 94303. IBM may use and distribute any of the information 
you supply in any way it believes appropriate without incurring any obhgation whatever. 
You may, of course, continue to use the information you supply. 

© Copyright International Business Machines Corporation 1984, 1985, 1986 



About This Book 



This book is intended for people who are planning to install the IBM Event Driven 
Executive Communications Facility for the Series/ 1. It assumes that you already 
understand the Communications Facility's functions and know how your 
installation is going to use the Communications Facility. If you need introductory 
information about the Conmnmications Facility, refer to Series/ 1 EDX 
Communications Facility Introduction^ GL23-0103. Some sections of the book 
assume you are familiar with systems network architecture (SNA); the 
International Telegraph and Telephone Consultative Committee (CCITT) 
Recommendations (X.2S in particular) for data communication networks; and the 
Series/1-PC Connect for EDX (5719-CNl). See the publications list for book 
titles on these subjects. 

In this book: 

Asynchronous adapter is used to mean feature programmable communications 
adapter, multifunction attachment, or 4950/5170-495 terminal/host adapter. 

Series/ 1 -PC Connect Attachment is used to mean a Series/ 1 attachment card 
(feature number 4000) and a PC extender card shipped with this feature. 

3101 is used to mean 3101 terminals (models 12, 13, 22, and 23), 3161, 3163, or 
3164 terminals in 3101 emulation mode, and IBM Personal Computers running in 
3101 emulation mode as if they were 3277 model 2 terminals. 

EDX Secondary SNAl refers to the licensed program 5719-SXl. 

EDX Secondary SNA2 refers to the licensed program 5719-XX9. 

EDX-SNA refers to both the EDX Secondary SNAl and SNA2. It is used to 
indicate functions supported by both versions of SNA. 

This book describes the functions and components of the Communications Facility 
and gives you the information you need to define, install, and start using your 
communications configuration. To that end, it has these chapters: 

• "Communications Facility Components" on page 1 introduces the programs 
and data sets that make up the Communications Facility. It explains 
Communications Facility concepts and facilities that you'll need to understand 
before you begin configuring and installing your system. 

• "Defining Stations" on page 45 describes the various types of stations you 
may need to define and explains how to define each one. 
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• "Using the Supplied Input/Output Control Programs" on page 71 explains the 
requirements and restrictions you need to consider when using the 
input/output control programs supplied as part of the Communications 
Facility. 

• "Communications Facility Data Sets" on page 179 describes the data sets that 
are used to hold Communications Facility information, and explains how to 
change their contents, 

• "Creating $.SYSPD" on page 187 explains the structure of the program 
dispatcher data set, and gives the syntax of the statements that create entries in 
the data set. 

• "Creating Disk-Queue Data Sets" on page 207 explains how to create the data 
sets that hold messages that are queued on disk rather than in processor 
storage. 

• "Planning Storage Requirements" on page 213 shows how to determine how 
much processor storage the Communications Facility will require. It includes 
tables that list the sizes of the Communications Facility modules as distributed 
from ISD. 

• "Coding Supervisor Definition Instructions" on page 235 shows how to code 
instructions to define elements of your Communications Facility configuration 
to the EDX supervisor. 

• "Installing the Communications Facility" on page 25 1 explains how to install 
the Communications Facility. 

• "Sample Configurations" on page 269 presents examples of Communications 
Facility configurations. Each example includes a diagram of the configuration; 
an explanation of the message flow between stations; station definitions; EDX 
definitions; and the EDX link control data set. 

• "Maintaining the Communications Facility" on page 445 explains how to 
assemble and link-edit Communications Facility programs. 

• The "Glossary" presents the definitions of technical Communications Facility 
terms and acronyms. For EDX definitions, see the appropriate book. 

• The "Index" is a conventional index to the publication. 

To use this book effectively, you will need a working knowledge of the Event 
Driven Executive (EDX) operating system. Pertinent publications include: 

• Series /I Event Driven Executive Installation and System Generation Guide, 
SC34-0646 

• Series/ 1 Event Driven Executive Operation Guide, SC34-0642 

• Series/ 1 Event Driven Executive Language Programming Guide, SC34-0637 

• Series/ 1 Event Driven Executive Communications Guide, SC34-0638 %^_j ^ 

• Series/ 1 Event Driven Executive Language Reference, SC34-0643 
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■ J • Series /I Event Driven Executive Operator Commands and Utilities Reference, 

SC34-0644 

• Series/ 1 Event Driven Executive Messages and Codes, SC34-0636. 
Other Communications Facility publications you might refer to are: 

• Series/ J EDX Communications Facility Operator's Guide, SL23-010S (referred 
to in this book as the Operator's Guide) ^ which explains how to operate the 
Communications Facility using operator commands, IBM-supplied 
transactions, and utility programs. 

• Series /I EDX Communications Facility Messages and Codes, SL23-0120, which 
lists and explains the Communications Facility error and informational 
messages and the return codes from Communications Facility programming 
instructions. 

• Series/ 1 EDX Communications Facility Programmer's Guide, SL23-0106 
(referred to in this book as the Programmer's Guide) ^ which explains how to 
code application programs, device-support programs, transaction-processing 
programs, and command-processing programs to run under the 
Communications Facility. 

• Series /I EDX Communications Facility Debugging Guide, LL23-0109 (referred 
to in this book as the Debugging Guide), which describes the Communications 
Facility modules, suggests steps to follow in debugging, and explains how to 
submit an authorized program analysis report (AFAR) to IBM. 

For information about the Series/ 1 -PC Connect, see the Series/ 1 -PC Connect for 
the Event Driven Executive Communications Facility, SC34-0698. 

For information about the Communications Facility /Host licensed program, see 
Series /I Communications Facility/ Host General Information, GH20-2485. 

For information about the EDX X.25/HDLC Communications Support licensed 
program, see Series/] Event Driven Executive X.2 5 / HDLC Communications 
Support Programming and Operating Reference Manual, SC09-1030, referred to in 
this book as the XHCS Programming and Operating Reference. 

If you need information about 3101 devices, see ib&SlOl Display Terminal 
Description, GAl 8-2033. 

If you need information about 3161 or 3163 display stations, see the 3161/3163 
Display Station Operator Reference and Problem Solving Guide, GAl 8-23 11. 

If you need information about 7485 devices, see the 7485 Display Terminal 
Description, GAl 8-2075. 

U you need information about the 4978 or 4980 display terminal, see the: 

• Series /I 4980 Display Station Description and Reference, GA2 1-9296 

• Series/ 1 4978-1 Display Station and Attachment General Information, 
GA34-1550. 
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If you need mformation about 3270 devices, see the: 

• 3270 Information Display System: 3271 Control Unit, 3272 Control Unit, 3275 
Display Station Description and Programmer's Guide, GA23-0060 (referred to 
in this book as the 3271 Guide) 

• 3270 Information Display System: 3274 Control Unit Description and 
Programmer's Guide, GA23-0061 (referred to in this book as the 3274 Guide) 

• 328 7 Printer Component Description, GA27-3 153. 

If you're using EDX Secondary SNAl, see the Event Driven Executive: Systems 
Network Architecture and Remote Job Entry Guide, SC34-0402 (referred to in this 
book as the EDX Secondary SNAl Guide). 

If you're using EDX Secondary SNA2, see the Event Driven Executive: Systems 
Network Architecture and Remote Job Entry Guide, SC34-0773 (referred to in this 
book as the EDX Secondary SNA2 Guide), 

If you need more information about binary synchronous communication (BSC) 
protocol, see General Information — Binary Synchronous Communications, 
GA27-3004, and Series/ 1 Binary Synchronous Features Description, GA34-0244. 

If you're using the multifunction attachment feature, see the Multi-function 
Attachment Feature Diskette Initialization User's Guide, GA34-0147, and the 
Multi-function Attachment Feature and 4975 Printer Description, GA34-0144. 

For information about the channel attachment feature, refer to the Series/ 1 
System/ 370 Channel Attachment Feature and 4993 Model I — Series/ 1 System/ 370 
Termination Enclosure Description, GA34-0057. 

If you're using the Local Communications Controller, see the Series /I Local 
Communications Controller Feature Description, GA34-0142. 

If you're using the Series/ 1 -PC Connect Attachment, see the Series/ 1 -Personal 
Computer Channel Attachment Description, GA34-0287. 

If your system is going to communicate with the Realtime Programming System's 
Communications Manager, you may want to refer to the Series/ 1 Realtime 
Programming System Communications Manager Assembler Language Programmer's 
Guide, SL23-0123, which explains Communications Manager message formats; 
and the Communications Manager Operator's Guide, SL23-0128, which explains 
Communications Manager conmiands. 
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Summary of Amendments 



Only changes affecting the content of this book are listed in the Summary of 
Amendments. 



Version 2.1 PTF 2 



The following changes were made between the Commimications Facility Version 
2.1 PTF 1 and Version 2.1 PTF 2: 

EDX SYSTEM Statement Support: Communications Facility now supports the 
COMBASE parameter of the EDX SYSTEM statement. This support allows you 
to use a partition, other than partition 1, as the Communications Facility common 
area. The following changes were made: 

• A description of the new storage pool, S$CFDCBS, was added to 
"Communications Facility Components" on page 1. 

• The descriptions of DEFINE BRB and DEFINE BUFFERPOOL in "Coding 
Supervisor Definition Instructions" on page 235 were changed. 

• The storage requirements for the supervisor partition, $.IO06F0, and $.100680 
in "Planning Storage Requirements" on page 213 were changed. 

• Installation requirements were added to "Installing the Communications 
Facility" on page 251. 

Remote TCB Support for $.100670: The description of "4978/4980 Data Stream 
lOCP, $.100670" on page 137 was changed to reflect the new support. $.100670 
now places its device TCBs in the dynamic storage area instead of the station 
control block in S$POOL. "Planning Storage Requirements" on page 213 was 
updated to reflect this change. 

Retry Support: The description of "3270 Control lOCP, $.IO0AC0" on page 97 
was changed to add the new support. $.IO0AC0 now inactivates a control unit 
station if the maximum number of time-outs allowed are exceeded. The device 
station is not polled until the control unit station is started again by the operator. 
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Other Changes 

• The dynamic storage requirements for $.100674 have been changed in 
"Planning Storage Requirements" on page 213. 

• Appendix A, "Configuring and Connecting 3101 Display Terminals" on 
page 452.1 has been added to explain the hardware configurations required to 
connect a 3101 device to a Series/1 using the 3101 lOCP, $.IO06F0. 



Version 2.1 PTF 1 



The following changes were made between the Communications Facility Version 
2.1 and Version 2.1 PTF 1: 



EDX Secondary SNA2 Suppmi: Communications Facility now supports EDX 
Secondary SNA2, 5719-XX9. This support allows you to run Communications 
Facility with EDX Secondary SNAl or EDX Secondary SNA2. The following 
changes were made: 

• $.I014E8, the SNA lOCP, was modified to include the new SSaT. support. 

• Installation requirements were added to "Installing the Communications 
Facility" on page 251. 

• A new sample configuration, "Example 4: EDX Secondary SNA2 Connection 
to a Host" on page 296, was added. 



'%. 



J 



Version 2.1 



The following changes were made between the Communications Facility Version 
2.0 and Version 2.1: 

Series/ 1-PC Connect Support: A new lOCP, $.IO0AA8, was added to provide 
support for communication between a Series/ 1 and Personal Computers in a local 
area network (LAN). The following changes were made: 

• A description of the new lOCP was added to "Using the Supplied 
Input/Output Control Programs" on page 71 . 

• The lOCP's storage requirements are described in "Planning Storage 
Requirements" on page 213. 

• A new instruction, PCC, was added to "Coding Supervisor Definition 
Instructions" on page 235 . 

• Installation requirements were added to "Installing the Communications 
FacUity" on page 251. 

• Two new sample configurations were added: "Example 14: X.25 Connection 
between a Series/1 and DTEs" on page 406, and "Example 15: LAN with 
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Series/ 1 -PC Connect Attachment and EDX Secondary SNAl Connection" on 
page 418. 

• "Defining Node Stations" on page 61 was modified to include the PC node. 

Disk-server Suppmi: A new lOCP, $.I01CC8, was added to provide support for 
emulated PC disks. A description of the lOCP was added to "Using the Supplied 
Input/Output Control Programs" on page 7 1 . The lOCP's storage requirements 
are described in "Planning Storage Requirements" on page 213. 

$.DSFORAf: A new utility, $.DSFORM, which manages emulated PC disks, is 
described in "$.DSFORM, Emulated PC Disk Management Utility" on page 41. 
A description of the new control data set, $.DSPROF, has been added to 
"Communications Facility Data Sets" on page 179. 

Volume Station: A description of the volume station was added to "Defining 
Stations" on page 45. Iliis station represents an EDX volume that contains data 
sets representing emulated PC disks. 

CFBUF Usage: The Communications Facility now monitors the use of space in the 
message buffer pool (CFBUF). This new support is described in "Message Buffer 
Pool (CFBUF) Usage" on page 17. 

3101 Keyboard Change: Figure 25 on page 128 has been changed to show the 
new 3101 keyboard. 

Other Changes: 

• The non-RPQ 4978 lOCP, $.100670, is no longer supported. Its description 
was removed from "Using the Supplied Input/Output Control Programs." 

• 4978/4980 data stream lOCP is now called $.100670 and is described in 
"4978/4980 Data Stream lOCP, $.100670" on page 137. 

• The teletypewriter connected 3101 lOCP, $.100630, is no longer supported. 
Its description was removed from "Using the Supplied Input/Output Control 
Programs." 



The following changes were made between the Communications Facility Version 
1.2 and Version 2.0: 

X.25 Support: A new lOCP, $.IO0AB8, was added to provide support for 
communication using Recommendation X.25 protocol. The following changes 
were made: 

• A description of the new lOCP was added to "Using the Supplied 
Input/Output Control Programs" on page 7 1 . 

• The new data set, $.SYSX25, is described in "X.25 Call ID Data Set 
($.SYSX25)" on page 184. 
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• Two new modes, STOP and RETRY, are described in the section "STOP and 
RETRY Modes" on page 74. 

• The lOCP's storage requirements are described in "$.IO0AB8, X.25" on 
page 225. 

• A new sample configuration worksheet was added — ^Figure 18 on page 55; 
the line/terminal/ node worksheet — ^Figure 16 on page 53 — ^was changed to 
include DTE and DCE lines. 

• Installation requirements were added to "Installing the Communications 
Facility" on page 251. 

• Three new sample configurations were added: "Example 1 1 : Multiple Local 
Communications Controller and BSC Connections" on page 374, "Example 
12: X.25 Connection between Series/Is" on page 382, and "Example 13: 
X.25 Connection Between Series/ Is through an X.25 Network" on page 392. 

4980 Terminal Support: The description of "4978/4980 Data Stream lOCP, 
$.100670" on page 137 was changed to reflect the addition of the 4980 termmal. 
The keyboard is shown in Figure 29 on page 144. The Communications Facility 
data sets required for 4980 operation are described in "4980 Data Stream Data 
Sets ($4980CSA, $4980ISA, and $4980R0A)" on page 182. "Example 1: BSC 
Connection to a Host" on page 272 shows a 4980 as part of a Communications 
Facility configuration. 

LU-1 Suppmt: The Communications Facility now supports the Series/1 printers as 
LU-ls. A description of the new support is m "Printer lOCP, $.100674" on 
page 149. Two new modes, SCS and 3270 are explained in "3270 and SCS 
Modes" on page 75. Installation procedures are described in "Installing the 
Communications Facility" on page 251. "Example 3: EDX Secondary SNA 1 
Connection to a Host" on page 284, was changed to show LU-ls as part of a 
Communications Facility configuration. 

Model 30D and 60D Integrated Disk Storage Support: "Remote IPL" on page 37 
was changed to include the 30 megabyte and 60 megabyte integrated disks as 
remote IPL devices. (Communications Facility books call these disks DDSK-30 
and DDSK-60 for consistency with the Event Driven Executive books.) 

$,PNLVT1: A new utility $.PNLUT1, which prints panels defined by $.PANEL, is 

described in "$.PNLUT1, Panel Utility" on page 41. 

Module Names and Sizes: Figure 39 on page 216 and "Message Flow within a 
Node" on page 6 were updated to reflect all new and changed modules. 

31 OIF Device Station Use of Unmapped Storage: "3101 lOCP, $.IO06F0" on 
page 121 and "7485 lOCP, $.100680" on page 155 include changes to $.IO06F0 
and $.100680 related to use of unmapped storage. "Planning Storage 
Requirements" on page 213 was updated to reflect these changes. A step for 
converting your existing 3101F station definitions to new ones that use unmapped 
storage was added to "Installing the Communications Facility" on page 251. 
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Publications Changes: Step 6 of the installation procedures, "Edit the Supervisor 
Link Control Data Set," was expanded. Because more information was added to 
this section, the example link control data sets were deleted from the sample 
configurations. 
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Communications Facility Components 






The Communications Facility manages communication among programs and 
various input/output devices, such as terminals, printers, and communication lines. 
It supports communication within a Series/ 1, between Series/ Is, and between a 
Series/ 1 and other computers. It consists of programs that run under control of the 
Event Driven Executive (EDX) operating system. 

This chapter introduces the programs and data sets that make up the 
Communications Facility. It explains the Communications Facility concepts and 
facilities that you'll need to understand before you can begin the tasks of 
configuring and instaUing your Communications Facility system. 

Figure 1 on page 2 shows the components of the Communications 
Facility — programs, data sets, and pools of processor storage. The portions 
included in the EDX supervisor and the Communications Facility control program 
are required in every Communications Facihty system. Each of the other programs 
is loaded into processor storage only when its functions are needed. The figure 
shows Communications Facility data sets on the left and right, with lines 
connecting each data set to the primary programs that use it. 

A Communications Facility system can also include user-written programs that 
process message data or perform functions unique to your installation. 
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EDX Supervisor: 

Communications Facility language extensions 

Communications Facility system storage pool 



Communications Facility control program: 

Message dispatcher 
' Command processor 

Log processor 

Message buffer pool 



Communications Facility I/O control programs 



Communications Facility program dispatcher 



Communications Facihty transaction-processing 
programs: 

System transaction 

Transaction scheduler 

Remote management functions 
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Remote disk support 
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Communications Facility utUity programs 



Figure 1. Summary of Communications Facility Components 
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Data Sets 



The Communications Facility includes the data sets summarized in Figure 2. 



Name 


Contents 


$4980CSA 


4980 control store 


$4980ISA 


4980 image store 


$4980R0A 


4980 microcode patch data set 


$PCCROn 


PC Connect microcode patch data set. n is the EC level. 


$.DSPROF 


Control information for data sets used as emulated PC 
disks 


$.MENU 


Work session controller sample program menu 


$.RPQCSO 


4978 data stream (RPQ D02428) control store 


$.RPQISO 


4978 data stream (RPQ D02428) image store 


$.SYSIPL 


Communications Facility startup commands 


$.SYSLCC 


Local Communications Controller remote IPL 
transactions 


$.SYSMSG 


Text of error and informational messages 


$.SYSNET 


Station definitions 


$.SYSPD 


Program dispatcher startup commands, path definitions, 
transaction definitions, and transactions 


$.SYSPNL 


System panels (3270 screen images) 


$.SYSPRT 


4978 control and image stores, buffered printer data 


$.SYSX25 


X.25 network addresses 



Figure 2. Siuninary of Communicatioiis Facility Data Sets 

The chapter "Communications Facility Data Sets" on page 179 describes each of 
the data sets in detail and explains how you can modify them to suit your 
requirements. 

The data set of particular importance to this discussion of system components is 
$.SYSNET, the network configuration data set. $.SYSNET contains the 
definitions of stations. A station is a named unit of hardware or software managed 
by the Communications Facility. It represents a program or an I/O device, such as 
a terminal or a communication line, that sends and receives messages. There is one 
$.SYSNET data set for each node— -eaich Series/ 1 in a Communications Facility 
configuration. The $.SYSNET data set at a node contains the definitions of local 
stations (stations in that node) and of remote stations (stations in other nodes) to 
which local stations will send messages. The chapter "Defining Stations" on 
page 45 describes the various types of stations and explains how to define them. 
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System Storage Pool (S$POOL) 



The system storage pool (S SPOOL) is an area of processor storage that contains 
information about stations that have been started. When a station is started, a 
control block, called a station block, is created in S$POOL, and remains there until 
the station is halted. The station block contains all the information the 
Communications Facility needs to manage the station. The information in the 
station block comes from the station's definition in $.SYSNET. 

S$POOL may also contain other information: a program loader, which the 
program dispatcher uses, and work areas for some of the I/O control programs 
(the programs that manage devices). 

S$POOL is part of the EDX supervisor, and is mapped into all partitions in which 
Communications Facility programs run. The chapter "Installing the 
Communications Facility" on page 251 explains how to defioe S$POOL and 
include it in the supervisor. The chapter "Planning Storage Requirements" on 
page 213 explains how to calculate S$POOL's size for your installation. 



DCB Pool (S$CFDCBS) 



The device control block (DCB) pool is an area of processor storage that contains 
DCBs and interrupt handler routine calls for certain types of started device 
stations. Any hardware device managed by the Communications Facility without 
using EDX-provided I/O facilities requires a DCB in the DCB pool. 

The DCB pool is part of the EDX supervisor, and must be included in partition 1. 
The chapter "Installing the Communications Facility" on page 251 explains how 
to define S$CFDCBS and include it in the supervisor. The chapter "Planning 
Storage Requirements" on page 213 explains how to calculate the size of 
S$CFDCBS for your installation. 



Message Buffer Pool (CFBUF) 



The message buffer pool (CFBUF) is an area of processor storage that contains 
messages that have been sent but not yet received. CFBUF contains queues of 
messages — one queue for each destination station. Each station block in S$POOL 
contains a pointer to the station's message queue in CFBUF. 

At your option, you may queue low-priority messages on disk. If you take this 
option, there is another storage pool, used for file control blocks. A file control 
block contains information about a station that has a message queue on disk. 

Both of these pools are in the dynamic storage of the Communications Facility 
control program. The chapter "Planning Storage Requirements" on page 213 
explains how to estimate how big the d3mamic storage should be for your 
installation and how to alter the distributed size. 

The Communications Facility monitors the use of space in the message buffer pool. 
The section "Message Buffer Pool (CFBUF) Usage" on page 17 explains how you 
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^^ can display inf onnation on the usage of the message buffer pool and how you can 

^J! regulate the flow of messages depending on the usage levels of CFBUF. 

Language Extensions 

The Communications Facility includes a set of instructions that extend the Event 
Driven Executive Language (EDL). These instructions are called language 
extensions. When you install the Communications Facility, you include the support 
for the language extensions in the EDX supervisor, as explained in the chapter 
"Installing the Conomunications Facility" on page 251. The supplied 
Communications Facility programs use the language extension instructions, and 
you can use them in your application programs. 

The instructions fall into these categories: 

Message management instructions, used to send and receive messages. 

Storage management instructions, used to get and free blocks of processor storage. 

Station management instructions, used to create and delete station blocks and to 
control stations. 

32 70 data stream instructions, used to create 3270 data streams and to extract data 
from them. 

\^' A data move instruction, used to perform indexed and indirect moves. 

A system facilities instruction, used to gain access to various Communications 
Facility control blocks. 

A task control instruction, used by I/O control programs (lOCPs) to activate and 
deactivate tasks. 

Queue management instructions, used to put elements on queues and to remove 
elements from queues. 

Supervisor definition instructions, used to define elements of a Communications 
Facility configuration to the EDX supervisor. These instructions are described in 
this book, in the chapter "Coding Supervisor Definition Instructions** on page 235. 

All the instructions are described in the Programmer's Guide. 
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Communications Facility Control Program 



The control program is that part of the Communications Facility that provides 
basic, required services. It contains message dispatcher, command processor, and 
log processor functions — ^and the dynamic storage used for the message buffer pool 
and the file control block pool. 

There are two versions of the control program. One, $.CFS, supports queumg of 
messages only in processor storage. The other, $.CFD, supports queuing of 
messages in processor storage and on disk. You start the version you want by 
issuing an EDX $L command to load it. Once either version is loaded, it sets the 
name in its program header to $.CF. 



Message Dispatcher 



When a message is sent, the message dispatcher determines its destination and 
places it on the destination station's message queue, either in processor storage or 
on disk. Message dispatching is performed partly by the SEND instruction and 
partly by the control program. The SEND instruction dispatches messages that are 
queued in processor storage. The SEND instruction and the control program 
together dispatch messages that are queued on disk. 

A message can be as large as 32K bytes and must be contained in a single storage 
area. The Communications Facility does not support segmented messages. 

Message Flow within a Node ^4j^ 

Figure 3 on page 7 is an example of message flow within a node. It shows how 
messages flow between an application program and terminals. An lOCP manages 
the terminals. Station blocks TERMl, TERM2, and TERMS represent the 
terminals, and station block APROG represents the application program. The 
numbered lines show the flow of a message from one of the terminals to the 
application program and the flow of the response from the application program 
back to the terminal. 

Q The lOCP reads data from the terminal represented by station TERMl 

and builds a message in its working storage area. 

Q The lOCP issues a SEND instruction specifying TERMl as the origin 

station and a null destination station. lOCPs know the names of stations 
they manage, but they are not responsible for knowing the destinations of 
the messages they send. 

The SEND instruction builds a message header that includes the message's 
type, priority, origin, and destination. The SEND instruction acquires 
space in the message buffer pool and moves the header and message to 
the pool. 

Q The message dispatcher examines the header. The destination is null, so 

the message dispatcher examines the origin station's station block to find 
the default destination. When you define a station, you can specify a 
default destination for messages it sends. This connection from one 
station to another is called a direct link vector, or just a direct link. As 
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Figure 3. Message Flow within a Node 



shown in Figure 3, station TERMl is linked to APROG, so the message 
dispatcher places the message on APROG's message queue. If the origin 
station (TERMl) had no direct link, the message would be undeliverable. 

The application program issues a RECEIVE instruction to get a message 
from station APROG's message queue. The RECEIVE instruction moves 
the message to the receiving program's working storage area, adjusts 
queue pointers, and frees the space in the message buffer pool. The 
receiving program always receives the message data. It can optionally 
receive either the entire message header or the name of the origin station. 
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Application programs that communicate with multiple users don't usually 
care which particular station they receive a message from. They just save 
the origin of each message and direct the response back to that station. 

Q The application program processes the message, builds a response, and 

issues a SEND instruction specifying itself as the origin station and 
TERMl as the destination station. 

Q The message dispatcher examines the message header. The destination is 

specified, so it places the message on station TERMl's message queue. 

Q The lOCP issues a RECEIVE instruction to get a message from station 

TERMl's message queue. 

Q The lOCP writes the message data to the terminal represented by station 

TERMl. 

Communications Facility programs that send messages usually don't wait for the 
destination station to receive a message. Instead, they wait only until the message 
is placed on the destination station's message queue. In the example, the lOCP 
resumes processing input or output for its stations at the end of step Q. The 
appUcation program receives its next message (or waits for one to be placed on its 
message queue) at the end of step Q. You can write application programs that 
wait until a message has been received (or received and processed) at its 
destination, but none of the lOCPs or other Communications Facility programs 
work that way. 



/if ^ 



Message Flow between Nodes x^y 

Figure 4 on page 9 is an example of message flow between nodes. It shows how 
messages flow between an application program in one node and terminals in 
another node. In each node, there is an lOCP that manages the communication 
hne between nodes; a station that represents the remote node; and stations that 
represent the remote stations to which local stations will send messages. Each 
station definition includes the identification of the node in which the hardware or 
program represented by the station exists. In node 1 , the stations that represent 
the terminals (only one of which is shown in the figure) have node ID 1 ; stations 
NODE2 and APROG have node ID 2. In node 2, the station that represents the 
application program has node ID 2; stations NODEl, TERMl, TERM2, and 
TERM3 have node ID 1. 

Q The lOCP that manages the terminals reads data from the terminal 

represented by station TERMl and builds a message in its working 
storage area. 

Q The lOCP issues a SEND instruction specifying TERMl as the origin 

station and a null destination station. 

The SEND instruction builds a message header that includes the message's 
type, priority, origin, and destination. The SEND instruction acquires 
space in the message buffer pool and moves the header and message to 
the pool. 



o 
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01 The message dispatcher in node 1 examines the header. The destination is 

null, so the message dispatcher examines the origin station's station block 
to find the default destination. As shown in Figure 4 on page 9, station 
TERMl is Unked to APROG, so the message dispatcher places that 
information in the message header. 

Because station APROG is in node 2, the message dispatcher places the 
message on the queue of the station that represents that node (NODE2). 

Q The lOCP in node 1 that manages the communication Une issues a 

RECEIVE instruction to get a message from station NODE2's queue. 
The RECEIVE instruction moves the message to the receiving program's 
working storage area, adjusts queue pointers, and frees the space in the 
message buffer pool. 

Q The lOCP writes the message header and data to the communication line; 

the lOCP in node 2 reads it. 

Q The lOCP in node 2 sends the message with its header, which specifies 

that the origin station is TERMl and the destination station is APROG. 

Q The message dispatcher in node 2 examines the header. The destination is 

APROG, so the message dispatcher places the message on APROG's 
message queue. 

Q The application program issues a RECEIVE instruction to get a message 

from station APROG's message queue. (^ "\ 

\^ 
Q The application program processes the message, builds a response, and 

issues a SEND instruction specifying itself as the origin station and 
TERMl as the destination station. 

The message dispatcher in node 2 examines the message header. The 
destination, TERMl, is in node 1, so the message dispatcher places the 
message on the queue of the station that represents that node, NODEl. 

The lOCP in node 2 issues a RECEIVE instruction to get a message from 
station NODEl's message queue. 

The lOCP writes the message header and data to the communication Une; 
the lOCP in node 1 reads it. 

The lOCP in node 1 sends the message with its header, which specifies 
that the origin station is APROG and the destination station is TERMl. 

The message dispatcher in node 1 examines the header. The destination is 
TERMl, so it places the message on TERMl's message queue. 

The lOCP that manages the terminals issues a RECEIVE instruction to 
get a message from station TERMl's message queue. 



The lOCP writes the message data to the terminal represented by station 
TERMl. 



o 
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Communication between nodes can be over a point-to-point BSC line, a multipoint 
BSC line, a Local Communications Controller ring, or an HDLC line. The flow of 
messages is somewhat different for each type of connection. The chapter "Sample 
Configurations" on page 269 contains an example of each type of connection. 
Each example explains what station definitions are required and gives a detailed 
description of the message flow. 



Message Priority 



Disk-Queued Messages 



The sender specifies the priority of a message as an operand of the SEND 
instruction. Priorities range from 1 (highest priority) to 127 (lowest priority). The 
default priority, which all the lOCPs and other Communications Facility programs 
use, is 127. 

When the message dispatcher places a message on a queue, it does so according to 
the message's priority. Suppose that a station's message queue contains messages 
of priorities SO and 100. A message with priority less than 50 will be placed at the 
top of the queue, and a message with priority greater than 100 will be placed at the 
end of the queue. A message with priority 50 will be placed after the older priority 
50 messages. 

The RECEIVE instruction always transfers the first message on a queue. Because 
messages are queued by priority, they are received by priority. 



When you define a station, you can specify that the lowest-priority (priority 127) 
messages sent to it are to be queued on disk. Each station that is to have a disk 
queue requires a separate data set. The chapter "Creating Disk-Queue Data Sets" 
on page 207 explains how to create them. 

To use disk queues, you must start the version of the control program that supports 
disk queuing, $.CFD. Starting a station that has a disk queue also opens its 
disk-queue data set. When a priority 127 message is sent to the station, the 
message dispatcher writes the message to the disk-queue data set. All messages of 
higher priority are queued in processor storage. 

Stopping or halting a station with a disk queue also closes its disk-queue data set. 
If the disk queue contains messages that have not yet been received, those 
messages are retained and are available when the station is next started. If the 
Communications Facility terminates abnormally, storage-queued messages are lost, 
but disk-queued messages are not; they are available when the system is restarted 
even though the data sets were not closed. 

If you don't want a station to receive disk-queued messages from a previous 
session, use the cold start option. This option causes any disk-queued messages 
from a prior session for the station to be discarded before the station can receive 
messages. 
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Controlling Message Flow 



You control message flow by issuing commands. The start command enables the 
flow of messages to and from a station. The stop and halt commands disable the 
flow of messages to and from a station. The link command defines or changes the 
destination of messages sent by a station. The modify command changes the 
attributes of a station, some of which affect message flow. 

Starting a station creates its station block in S$POOL and opens its disk-queue data 
set (if it has one). The station can send messages, and messages can be sent to it. 

Stopping a station flags its station block as inactive and closes its disk-queue data 
set (if it has one). Stopped stations can send messages, but those that are managed 
by lOCPs or other Communications Facility programs don't. Messages can't be 
sent to a stopped station. There are two exceptions to this rule: status messages 
can be sent to a stopped station; any type of message can be sent to a stopped 
message station. 

A station may have messages on its queue when it is stopped. Those queued in 
processor storage can be received. If they aren't received, they're available when 
the station is restarted. Pending disk-queued messages can't be received. 

Halting a station closes its disk-queue data set (if it has one), discards any pending 
storage-queued messages, and deletes the station's control block from S$POOL. 
The station is in the same state as if it had never been started. 

You can use the link command to change the direct link vector of a station. You 
can change the link at any time, whether the station is active or not. 

You can use the modify command to set a station on input hold or output hold. 
When a station is on input hold, all messages it sends are discarded. The messages 
are not undeliverable, as discussed in the next section; they are thrown away. 
When a station is on output hold, messages can be sent to it, but it can't receive 
any messages from its queue. 



Undeliverable Messages 



The message dispatcher may be unable to deliver messages, for various reasons: 

• The destination station does not exist (it has no station block). 

• The destination station is stopped. 

• The destination is not known; the message was sent with a null destination, and 
the origin station doesn't have a direct link vector. 

• The destination is a remote station, and the station that represents the remote 
node does not exist or is stopped. 

When the message dispatcher can't deliver a message, it puts the message on the 
queue of the station named $. WASTE. If there is no such station, the message 
dispatcher discards undeliverable messages. If station $.WASTE has a disk queue, 
all messages to $. WASTE are queued on disk, regardless of their priority. 



\0 
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Message Types 
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The use of $. WASTE is not restricted to the message dispatcher. Any program can 
send messages to $. WASTE. The program dispatcher sends messages to $. WASTE 
for the reasons described in the section "Undeliverable Transactions'* on page 33. 
No other Communications Facility programs use $.WASTE. They discard invalid 
data and issue a log message to report the error. 

The easiest way for you to handle undeliverable messages is to deHne $.WASTE as 
a message type station with a disk queue, and use utility program $.UT2 to process 
the undeliverable messages. $.UT2 lets you obtain a listing of messages and purge 
them or send them to other destinations. If you use $.WASTE, you should assign it 
a disk queue and use the disk-queuing version of the control program. If you don't, 
the message buffer pool may fill up with undeliverable messages. 

You can handle undeliverable messages in other ways by writing a program to 
receive and process undeliverable messages. The Programmer's Guide describes the 
format of the messages sent to $.WAST£. 

Don't define $. WASTE as a remote station. If you do, it won't be used; 
undeliverable messages will be discarded. 



There are five types of Communications Facility messages: data, transaction, 
command, status, and log. 

A data message contains data sent from one station to another. The data is 
meaningful only to its destination. Routing of data messages is described in 
"Message Flow within a Node" on page 6 and "Message Flow between Nodes" on 
page 8. 

A transaction message contains information that causes execution of a program 
(called a transaction-processing program) somewhere in the configuration. This 
information is in the first part of the message, which is a fixed-format area called 
the transaction header. A transaction message may also contain data to be passed 
to the transaction-processing program. The initial destination of all transaction 
messages is the program dispatcher, the component of the Communications Facility 
that manages transaction-processing programs. Transaction messages are routed to 
it, just like data messages. It receives transaction messages and handles them as 
explained in the section "Program Dispatcher" on page 25. 

A command message contains a command, and is sent to the command processor. 
A command message can be routed between nodes, just like a data message. When 
it reaches the node where it is to be processed, it is routed to the command 
processor task of the control program. 

A status message contains control information, such as an X.25 control message or 
a command, that tells a program to stop or halt. A status message is routed like a 
data message. If the status message is an X.2S control message, it can also be 
routed to an alternate link as described in "Linking Stations" on page 65. When a 
program receives a status message, the RECEIVE instruction completes with a 
unique status condition (+6). 

A log message is an error or informational message to be sent to the system log. 
The message dispatcher doesn't route log messages. They are routed directly to the 
log processor task of the control program. 
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Command Processor 



The command processor processes the commands, called CP commands, 
summarized in Figure 5. These commands allow you to control your 
Communications Facility system and display information about it. 



o 



Command 


Activity 


DEF 


Define a new station 


F 


Modify attributes of an existing station 


Fn,F 


Display or modify the disk-queuing parameters of a 
station 


H 


Halt a station 


HELP 


List CP commands and their functions 


LINK 


Define a connection between two stations so that 
messages may be routed between them 


P 


Stop a station 


Q 


Display information about stations, BSC lines, FDX 
terminals, X.25 connections, and EDX-SNA PUs and LUs 


READ 


Execute commands contained in a data set 


S 


Start a station 


SET 


Assign a log device for system log messages, set the node 
address of a Series/ 1, or set levels in CFBUF. 


ST 


Display message activity statistics and Local 
Communications Controller hardware statistics 


V 


Remove a node from the Local Communications 
Controller ring 



Figure 5. Summary of Comniand Processm- (CP) Commands 

The command processor and the program dispatcher together process the 
commands, called PD commands, summarized in Figure 6 on page 15. These 
commands allow you to control the actions of the program dispatcher and display 
information about it. 
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Command 


Activity 


C 


Change the cell identifier 


CP 


Send a command to a cell 


F 


Modify a path or transaction table entry 


H 


List PD commands and their functions 


I 


Insert a path or transaction table entry 


ID 


Check whether a cell is active 


M 


Send a message to an EDX terminal 


P 


Stop a path or transaction 


Q 


Display the transaction and path tables, remote disk 
definitions, and scheduler entries 


R 


Remove a path or transaction table entry 


RC 


Set retry counts for program load 


S 


Start a path or transaction 


T 


Send the system time and date to a cell 


TRAC 


Start or stop a trace of transactions 


TRAN 


Send a transaction 


UP 


Set user program ($.UPxxxx) load mode 



Figure 6 . Summary of Program Dispatcher (PD) Commands 

There are several ways of entering commands. You can enter them from a terminal 
by pressing ATTN and entering CP or PD followed by the function and parameters 
you want. For example, to start a station named APROG: 

> CP S APROG 

Commands can also be read from a data set, entered as transactions, issued by 
programs, or entered with the diagnostic aid utility, $.UT1. 

A few Communications Facility commands can be entered only from a terminal. 
They are summarized in Figure 7. 



Command 


Activity 


CPRSTART 


Restart the Communications Facility 


GOTEST 


Begin execution of a transaction program in test mode 


TRAN 


Issue a transaction 


WSC 


Start work session controller terminal 






Figure 7. Sununary of Other Commands 

The Operator's Guide gives the syntax and an example of each command and more 
information about the different ways of entering commands. 
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Log Processor 



The command processor also processes commands sent from a Communications 
Manager system over a Local Communications Controller ring. These commands 
allow a Communications Manager operator to start, stop, and obtain information 
about Communications Facility stations. The commands are described in the 
Communications Manager Operator's Guide. 

The command processor consists of a task in the control program and a set of 
transient programs, one for each command. The task receives control when a 
command is issued. It translates the command to uppercase, extracts the verb 
(xxxx) from the command, and loads the transient program named S.CPxxxx. The 
program processes the command and terminates, returning control to the initial 
task, which can then receive another command. 

You can add your own commands to the Communications Facility. The 
Programmer's Guide explains how to write a command-processing program and 
includes an example program. 



The log processor processes log messages issued by Communications Facility 
programs. It builds a formatted message and sends it to the system log. The 
message contains the time of day, a message ID, the name of the issuing program, 
optional variable information passed by the issuing program, and fixed text taken 
from the message data set $.SYSMSG. 

The Messages and Codes gives a detailed description of the format of log messages. 
It also lists and explains all the log messages issued by Communications Facility 
programs. 

There is one system log in each node. The default is the terminal from which the 
control program is loaded. You can use the CP SET LOG command to assign the 
system log to an EDX device or to a Communications Facility station, or to turn 
off logging. 

When the system log is an EDX device, the log processor shares the device with 
other EDX tasks. If the device is busy, the log processor and the task that issued 
the log message wait until the device is available. When you assign the system log 
to an EDX device, the device should be one that is used only briefly (or not at all) 
by other EDX tasks. 

Log messages issued by the command processor in response to a command entered 
at a terminal are displayed at that terminal and sent to the system log. All log 
messages issued by the program dispatcher are displayed at the terminal where the 
program dispatcher was started and sent to the system log. 

You can process log messages however you want by writing a program that assigns 
the system log to its station and then receives and processes all log messages. The 
Programmer's Guide explains how you can use this technique to provide a central 
system log for a multinode configuration. 

When you assign the system log to a Communications Facility station, you should 
assign a disk queue to that station. If the log station doesn't have a disk queue, the 
system message pool can be flooded with log messages, and a deadlock can occur. 
For example, if the log device is one of several 3270 terminals, the system message 
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pool may fill up with log messages that aren't being received. This happens 
because the program that manages the terminal is waiting for space to send a 
message to some other terminal. The disk queue that you assign to a log station 
should be large enough to avoid losing log messages during periods of high activity. 



Message Buffer Pool (CFBUF) Usage 



CFBUF Usage Classes 



CFBUF Usage Levels 



The Communications Facility monitors the use of storage in the message buffer 
pool (CFBUF). It allows you to regulate the flow of messages from a station, 
depending on how much storage in CFBUF is in use. 



When you define a Communications FaciUty station, the station is automatically 
assigned to one of two CFBUF usage level classes, class 1 or class 2. Class 1 
stations can use CFBUF up to level 1 and class 2 stations can use CFBUF up to 
level 2. Class 1 is the default class for all Communications Facility stations. 
Messages can be sent from the station as long as usage of CFBUF has not 
exceeded the level allowed for the station's usage class. Messages with unknown 
origins are treated as messages coming from usage class 1 stations. 

You can use the CP Q NET command to display a station's usage class. You can 
use the CP F CLASS command to change the station's usage class. These 
commands are described in the Operator's Guide. 



The total amount of storage available in the message buffer pool (CFBUF) is 
divided into three levels of usage, as shown in Figure 8 on page 18. When you 
first start the Communications Facility, CFBUF is below level 2. A small amount 
of storage in CFBUF is used for two system buffers and a control block, but most 
of the storage is available. As messages are sent and more storage is used but no 
storage is freed, CFBUF usage moves above level 2. If storage is still not freed, 
CFBUF usage level moves above level 1 . 

When CFBUF usage is below level 2, messages can be sent from stations with 
usage class 2 or class 1 . When CFBUF usage exceeds level 2 but is below level 1 , 
only messages from usage class 1 stations can be sent. When usage exceeds level 1 , 
only CP commands can be issued. You should issue commands to free message 
storage when usage exceeds level 1. For example, you can stop stations that have 
accumulated messages on their queue. 

The default value for level 1 is set by the system to prevent the last 512 bytes of 
CFBUF storage from being used up. You can not modify level 1 . 

The default value for level 2 is 85% of CFBUF in use. You can use the CP SET 
CFBUF command to set the value for level 2. You can not set level 2 to allow 
more CFBUF to be in use than allowed by level 1 . The CP SET CFBUF command 
is described in the Operator's Guide. 



o 
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Reserved (512 Bytes) 

Reserved (System Use) 
Level 1 

— - Warning Level 

Level 2 



Q □ 



Q Available for data, transaction, or status messages 

when origin station has usage class 2. 

Q Available for data, transaction, or status messages 

when origin station has usage class 1, 
or when origin station is not known. 

Q Available for command messages, regardless of origin. 

Figure 8. CFBUF Usage Levels 






Warning Level 



Displaying Current Usage 



The Communications Facility can log an error message as a warning when more 
than a certain percentage of the CFBUF is full. The warning processor of $.CF 
issues an error message when the usage of CFBUF exceeds the warning level. The 
default warning level at which a system log message is issued is set at 90%. You 
can use the CP SET CFBUF command to specify a warning level. After a warning 
message is issued, another warning message is not issued until CFBUF usage level 
falls 10% below the warning level and then exceeds it again. 



You can use the CP Q CFBUF command to display the current usage level 
thresholds and the current usage of CFBUF. This command also displays the 
highest percentage of CFBUF in use since the Communications Facility was 
loaded. The command is described in the Operator's Guide. 
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I/O Control Programs 



The Communications Facility includes several device-support programs, called I/O 
control programs or lOCPs. 



Functions of an I/O Control Program 



An lOCP manages devices and the Communications Facility stations that represent 
those devices. Each lOCP manages devices of a particular type, such as a terminal, 
printer, or communication line. An lOCP can handle multiple devices. It consists 
of a main task and one or more subtasks for each individual device. 

The main task receives and processes commands to start, stop, and halt the stations 
that the lOCP manages. The main task attaches at least one subtask when a device 
is started. The subtask(s) manages all communication with the device. It reads 
data from the device and sends that data into the system in the form of 
Communications Facility messages. It receives messages from its station's queue 
and writes them to the device. 

A subtask consists of reentrant code and a task control block. The task control 
block or a pointer to it is contained in the station block that represents the device. 



Summary of Supplied I/O Control Programs 



Figure 9 on page 20 shows the lOCPs that manage host system connections, 
terminals, printers, and emulated PC disks. 

The lOCPs that manage host system connections are: 

• $.IO0AD0 manages communication over a System/370 channel attachment. 
The Series/ 1 appears to the host as a locally attached 3272 control unit with 
attached display stations and printers. There is a station to represent each 
emulated display station or printer. 

• $.IO0AE0 manages communication over a BSC multipoint line. The Series/ 1 
appears to the host as a 3271 control unit with attached display stations and 
printers. There is a station to represent each emulated control unit, display 
station, or printer. 

• $.I014E8 manages a Systems Network Architecture (SNA) connection over an 
SDLC line. The Series/ 1 appears to the host as a 3274-SDLC control unit 
with attached display stations and printers. In SNA terminology, it appears as 

a physical unit (PU) with logical units (LUs) : LU-2s (display stations) and 
LU-ls or LU-3s (printers). There is a station to represent the PU and each 
LU. 

The lOCPs that manage terminals, printers, and emulated PC disks are: 

• $.IO0AC0 manages communication with a 3270 system over a BSC multipoint 
line. 

• $.100670 manages 4978 display stations with the data stream RPQ (D02428) 
and 4980 display stations so they appear as 3277 display stations. This lOCP 
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Figure 9. lOCPs that Manage Host System Connections, Terminals, Printers, and Emulated PC Disks 
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used to be called $.100678 in the previous edition (Version 2.0) of 
Communications Facility. 

• $.IO06F0 manages 3101 terminals on a feature programmable communications 
adapter, a multifunction attachment, or a 4950/5170-495 terminal/host 
adapter so they appear as 3277 display stations. 

• $.100674 manages 4973, 4974, 4975, 5219, 5224, 5225 , or 5262 printers so 
they appear as 3286 or 3287 printers. 

• $.100680 manages 7485 terminals on a feature programmable communications 
adapter, a multifunction attachment, or a 4950/5170-495 terminal/host 
adapter so they appear as 3277 display stations. 

• $.I01CC8 allows you to use a Series/ 1 data set so that it appears to the 
gateway PC as a local disk device. The gateway PC is a Personal Computer 
connected to the Series/ 1 by Series/ 1 -PC Connect Attachment and its 
software support. The lOCP can control multiple volumes for multiple LANs. 
It handles one volume for each gateway PC. 

The messages sent to and received from all these lOCPs are 3270/BSC data 
streams. (The channel attach and SNA lOCPs remove BSC control characters 
before sending data to the host and append BSC control characters to data 
received from the host.) You can use the Communications FaciUty for 
communication between host appUcation programs and any of the terminals or 
printers over any of the three types of connection. This type of communication, 
called 3270 pass-through, requires no user programming. You need only define 
stations to represent the real devices, define stations to represent corresponding 
emulated devices, and link each pair of stations to each other. You can also write 
application programs that are independent of the type of terminal they 
communicate with or the type of connection to the host program they communicate 
with. 

Figure 10 on page 22 shows the lOCPs that manage connections between 
Series/ Is: 

• $.IO0AB0 manages communication between Series/ Is on a Local 
Communications Controller ring. The messages it transmits may or may not be 
3270 data streams. It transmits entire messages, including their headers, 
whatever their content. Some of the Series/ Is on the ring can be 
Communications Manager systems. The lOCP converts message headers from 
the format used by one system to that used by the other. 

• $.IO0AB8 manages communication between Series/ Is over an HDLC line, 
using CCITT Recommendation X.25 packet level procedures. The connection 
between the Series/ Is may or may not have an an intervening X.25 
packet-switching network. $.IO0AB8 transmits data and X.25 control 
information. The data may or may not include Communications Facihty 
message headers, depending on how stations are defined. When 
communications is through an X.25 network, some of the Series/ Is can be 
Communications Manager systems. 

• $.IO0AC0 and $.IO0AE0 can be used for communication between Series/ Is 
over a BSC multipoint line. $.IO0AC0 manages 3270 systems, and $.IO0AE0 
makes the Series/ 1 appear to be a 3270 system. 
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$.IO0A10 manages communication between two Series/ Is over a BSC 
point-to-point line. It transmits entire messages, including their headers, 
whatever their content. 



o 











$.IO0AB0 














$.IO0AB0 





Local Communications Controller 



HDLC 



$.IO0AB0 



$.100 AB8 



S.IOOACO 



BSC Multipoint 



2 



S.IOOAIO 



tiDLC^^ 







$.IO0AB8 









HDLC 















S.IOOAEO 








S.IOOAEO 























S.IOOAIO 











Figure 10. lOCPs that Manage Connections between Series/ Is 



Figure 11 on page 24 shows the lOCPs that manage communication with other 
systems and devices: 

• $.100 AA8 manages communication between a Series/ 1 and a Personal 

Computer (PC) connected by a Series/ 1 -PC Connect Attachment. It allows 
all the PCs in the IBM PC Network to communicate with a Series/ 1 through a 
gateway PC (PC connected to the Series/ 1 by Series/ 1 -PC Connect 
Attachment and its software support). It also allows all the PCs on a non-IBM 
network to communicate with a Series/ 1, but the PCs on your network must 
meet the hardware and software requirements for the type of network you use. 
When the gateway PC is part of a local area network (LAN), the Series/ 1 



o 
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resources are available to all the PCs on the LAN. A LAN is created when 
PCs are interconnected by hardware and provided with software support to 
enable the PCs to communicate with each other. $.100 AA8 can manage 
multiple attachments to different PCs. 

• $.100 AB8 manages communication between a Series/ 1 and other computers 
or devices that function as X.25 data terminal equipment (DTE). The Series/ 1 
is connected by an HDLC Une using LAPB protocol and X.25 packet-level 
procedures, with or without an intervening X.25 packet-switching network. 

• $.100 A20 manages communication between a Series/ 1 and a variety of other 
systems over a BSC point-to-point line. $.IO0A20 uses a 2770- and 3741-like 
protocol. The format of the messages it transmits is whatever is required by 
the other system. 

The chapter "Using the Supplied Input/Output Control Programs" on page 71 
gives detailed information about each of the lOCPs. It explains the requirements 
and restrictions you need to take into account when you use them. 



Writing an I/O Control Program 



You can extend the Communications Facility to support other devices by writing 
lOCPs. The Programmer's Guide explains how to write an I/O control program 
and includes an example program. 






Intercepting Messages from an I/O Control Program 



You can write a program that intercepts all the messages that an lOCP sends into 
the system from the stations it manages. You may want to do this, for example, to 
provide an audit trail of messages by writing them to a data set before sending 
them on to their destination. The Programmer's Guide explains how to intercept 
messages from an lOCP. 



I/O Control Program Station Definitions 



You should make an entry in $.SYSNET for each of the lOCPs you plan to use. 
Define them as having type "USER" and a station name the same as the program 
name. 

lOCPs that are not defined in $.SYSNET can be started, but they can't be shut 
down. 



Starting I/O Control Programs 



You don't need to explicitly start lOCPs with a CP start command or a $L, unless 
you wish to control which partition the lOCP runs in. An lOCP is started 
automatically by the control program when the first station of the type it manages 
is started. The start command processor uses a station's type and subtype to 
determine which lOCP manages the station. For example, the type/subtype of a 
station that represents aSlOlFona feature programmable communications 
adapter is device/3 lOlF, which is recorded as a hexadecimal code in the station 
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Figure 11. lOCPs that Manage Connections to Non-Series/ 1 Devices 




HDLC 



Device 



definition in $.SYSNET. The code for device/3 lOlF is X'06F3', and the lOCP 
that manages such stations is $.IO06F0. 



If the required lOCP is not already started, the start command processor creates a 
station block to represent the lOCP and loads the program. 
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Shutting Down I/O Control Programs 



You shut down an lOCP by stopping or halting its station. When you do so, the 
lOCP halts all the stations that it manages, deletes its station block, and terminates 
execution. 



You can't stop or halt an lOCP if it isn't defined in $.SYSNET. 



Program Dispatcher 






The program dispatcher is that part of the Communications Facility that handles 
transaction processing. It routes transactions and manages the programs that 
process them. 

The program dispatcher is an optional part of the Communications FaciUty. It is 
required only to support transaction-processing programs — those provided with the 
Communications Facility and those written by users. 

The term transaction-processing program is used throughout this book to refer to 
programs that are executed in response to transactions. Note that the program may 
or may not — at your option — receive the text of the transaction itself. You can 
define transactions that just cause a program to be loaded and executed, without 
receiving the transaction as a message. 

To the message dispatcher, the program dispatcher is simply a station that 
represents a program. The name of the station and the program is $.PD. The 
program dispatcher receives transaction messages from its message queue and 
performs its transaction-routing function by sending them to other stations. 

The program dispatcher's actions are governed by information in the transaction 
messages, in a path table, and in a transaction table. The path table and 
transaction table contain information you specify in the $.SYSPD data set, as 
explained in the chapter "Creating $.SYSPD" on page 187. There is a $.SYSPD 
data set and, therefore, a path table and a transaction table for each Series/ 1 
where the program dispatcher runs. 



Transaction Messages 



The first part of a transaction message is a fixed-format header that identifies the 
transaction and the cell where it is to be processed. A cell is a Series/ 1 where the 
program dispatcher runs or a non-Series/ 1 host system where transactions are 
processed. 

The format of a transaction message is: 

1-4 5-6 7-10 11-12 13-« 



tidl 


cl 


tid2 


c2 


transaction data 
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where: 



tidl 



is the primary transaction identifier, a 4-character code that identifies the 
transaction. 



cl 



is the primary cell identifier, a 2-character code that identifies the cell where the 
transaction is to be processed. Two blanks or 00 means that the transaction is to 
be processed in the cell where it originated. Two asterisks mean that the 
transaction is a broadcast transaction, which is to be processed in all cells known 
to the program dispatcher. 



tid2 



is the secondary transaction identifier, whose meaning is defined by the program 
that processes the transaction. 



c2 

is the secondary cell identifier, whose meaning is defined by the program that 
processes the transaction. When c2 is ??, the program dispatcher replaces it with 
the ID of the cell where the transaction originated. 

transaction data 

is whatever data is sent to the program that processes the transaction. 

The minimum length of a transaction message is 6 bytes. The data portion is 
optional. If a transaction contains no data, the secondary transaction identifier and 
secondary cell identifier are optional. 

Transactions are usually originated by programs, perhaps in response to input from 
a terminal operator. They can also be read from a data set or entered from a 
terminal with the PD TRAN command. 






Path Table 



Transaction Table 



A path table has an entry for each remote cell known to the local program 
dispatcher. Each entry contains a cell identifier, the name of the station that 
represents the path to and from that cell, and optional path attributes. Program 
dispatchers use this information to route transactions from cell to cell, as explained 
in the section "Transaction Routing" on page 27. 



A transaction table has an entry for each transaction to be processed in the local 
cell. Each entry contains a transaction identifier, the name of the program that is 
to process the transaction, program attributes, and transaction attributes. The 
program dispatcher uses this information to route transactions to the programs that 
process them and to manage the programs, as explained in the section "Program 
Management" on page 31. 
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Transaction Routing 
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The initial destination of every transaction is a program dispatcher, which routes 
the transaction to its ultimate destination — a transaction-processing program. The 
routing may require that a program dispatcher in one cell send the transaction to a 
program dispatcher in another cell or to a non-Series/ 1 host transaction-processing 
system. Transactions can be routed between Series/ 1 cells over any of the 
connections the Communications Facility supports. Transactions can be routed to 
a non-Series/ 1 host over a BSC multipoint Une or an SDLC line (an SNA 
connection). They can also be routed over a channel attachment, but there are 
restrictions. These restrictions are explained in the Series/ l-to-System/370 
Channel Attach lOCP description, "Restrictions" on page 106. 

A program dispatcher routes a transaction to another cell by sending it to the 
station that represents the path to that cell, as defined in the path table. To the 
message dispatcher, a transaction is a data message; it places the message on the 
destination station's queue just as if it were an ordinary data message. 

A path station doesn't represent the physical connection (the communication line) 
between two cells. It represents the logical path from one program dispatcher to 
another or from a program dispatcher to a non-Series/ 1 host system. The chapter 
"Sample Configurations" on page 269 contains examples of configurations that 
include the program dispatcher. Those examples show how to define path stations 
and the stations that represent physical connections. 

Figure 12 on page 28 is an example of a multicell configuration with path stations 
defined. Paths are defined between cells: 

CI and HT 

CI and C2 

CI and C3 

CI and C4, through C2 

C2 and C4 

The program dispatcher can route messages to PC programs on a local area 
network (LAN) connected through a Series/ 1 -PC Connect Attachment. The 
program dispatcher routes the transaction through a path station which is a remote 
station representing the PC program. The PC program will receive the message 
with the program dispatcher header included in the message. 

Because some of the paths are defined as preferred paths, there is a path from any 
cell to any other cell. K preferred path is a path over which transactions for 
unknown cells are routed. 

A transaction that originates in cell C2 and that has C3 as its primary cell identifier 
is routed as follows: 

1. The program dispatcher in cell C2 receives the transaction from its message 
queue and examines the primary cell identifier to determine whether or not the 
transaction is to be processed in cell C2. If the primary cell identifier were C2, 
00, or two blanks, the transaction would be processed in cell C2. The primary 
cell identifier isn't any of those, so the program dispatcher examines its path 
table to determine whether or not the path to C3 is defined. It isn't, so the 
program dispatcher sends the transaction to the preferred path station, which 
represents the path to the program dispatcher in cell CI. 
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Figure 12. Example Multicell Configuration with Path Stations 
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Broadcast Transactions 



2. The program dispatcher in cell CI receives the transaction and examines the 
primary cell identifier. The transaction is not to be processed in cell CI, so the 
program dispatcher examines its path table. The path to C3 is defined, so the 
program dispatcher sends the transaction to the station that represents the path 
to the program dispatcher in cell C3. 

3. The program dispatcher in cell C3 receives the transaction and examines the 
primary cell identifier. The transaction is to be processed in this cell, as 
described in the section "Program Management" on page 31. 



A broadcast transaction is one whose primary cell identifier is **. When a program 
dispatcher receives a broadcast transaction, it processes the transaction in the local 
cell; sends it unchanged to the preferred path station, if one is defined; and sends it 
to each other path station with the ** replaced by the remote cell identifier. 

Any transaction can be a broadcast transaction. Some of the PD commands and 
system transactions use the broadcast facility. For example, the PD M (send 
message) command and the SYST MS transaction processor use it to send a 
message to all EDX terminals in all cells. 



3270 Data Stream Transactions 






Transactions are usually character strings built by a program, read from a data set, 
or entered from an EDX terminal with a PD TRAN command. Transactions can 
also be 3270 data streams. These are most likely to originate from a 
Communications Facility terminal (3277, 4978, 4980, 3101) that is linked to the 
program dispatcher. The programs that process such transactions may need to 
receive the entire data stream; the 3270 control information at the beginning shows 
which key was pressed to terminate the input and the position of the cursor. The 
program may also need to know the origin station name so that it can direct its 
response back to that terminal. 

To make routing of a data stream transaction possible, you must define it as a data 
stream transaction. If the transaction is processed in a cell other than the one in 
which the transaction originated, you must also define the paths over which it is 
routed as data stream paths. Then when the program dispatcher sends the 
transaction to a path station or to the transaction-processing program, it sends the 
entire data stream and specifies the origin station name it received. If you don't 
define a transaction or path as data stream and the program dispatcher receives a 
data stream, it removes the BSC and 3270 control information before sending the 
transaction and specifies itself (the station named $.PD) as the origin. The 
information removed is whatever precedes the first data field and the BSC control 
character (ETX) at the end. 

There is another data stream consideration — lOCPs that manage a BSC multipoint 
line, a channel attachment, or an SNA connection send and receive 3270/BSC 
data streams. You don't define these types of paths as data stream paths. The 
program dispatcher identifies them as such by the path station's type. It appends 
the required 3270/BSC control information to transactions before sending them to 
the path station. It removes 3270/BSC control information from transactions 
received from the path station. 
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Transaction Prefix 



Binary Transactions 



Some host transaction-processing programs require an 8 -character transaction 
identifier, rather than the 4-character one used by the Communications FaciUty. 
When you define the path to such a host system, you define a 4-character prefix. 
The program dispatcher appends the prefix to each transaction sent to that path 
station. 



3 



The data portion of transactions may be binary (any value from X'OO' to X'FF') 
rather than characters. You may, for example, transmit object programs or storage 
dumps as transactions. Binary data can be transmitted between Series/ Is and 
between a Series/ 1 and a host system connected through a channel attachment or 
an SNA connection. Host systems accessed through a multipoint BSC line may or 
may not support transmission of binary data. 

Binary data sent over a BSC hne must begin with the control characters DLE/STX 
(X'1002'), which signal start of transparent text. When you define a path as a data 
stream path, and the connection is a multipoint BSC line (either between Series/ Is 
or between a Series/ 1 and a host system), binary transactions must begin with 
DLE/STX. In all other cases, either the program dispatcher or the lOCP that 
manages the connection provides the required control characters. 

If a host system does not support transmission of binary data, you must specify 
when you define the path that data conversion is required. 

When you specify data conversion, the program dispatcher converts the data U J 

portion of transactions sent to the path station. It doesn't convert the transaction 
header, the preceding 3270/BSC control information, or the ETX at the end. 

The transaction data is converted as follows: 

• Bit of each byte that has a value less than X'40' is set to 1. 

• Bit of each byte that has a value of X'FF' is set to 0. 

• A control byte is inserted after each group of 7 data bytes and after the last 
group of 7 or fewer data bytes. Bits 1-7 of a control byte correspond to the 
preceding 7 data bytes; the control bit is set to 1 if the data byte was modified. 
Bit is set to 1 if the control byte has a value less than X'40'. 

The following example shows the hexadecimal value of transaction data before and 
after conversion. The underscored bytes are control bytes. 

Received: 4F F3 32 18 92 61 40 00 C2 96 FF 01 72 49 61 20 19 

Sent: 4F F3 B2 98 92 61 40 98 80 C2 96 7F 81 72 49 4C 61 AO 99 83 



Notice the last control byte, which is for a group of 3 data bytes. The control bits 
are right-justified. They correspond to the last 3 bytes of the group, not the first 3 
bytes. 
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When the program dispatcher receives a transaction from the path station, it 
removes the control bytes and restores the modified data bytes. The host 
transaction-processing program must perform corresponding conversions of the 
data it receives and sends. 



Program Management 



The program management functions of the program dispatcher make it possible to 
optimize the use of processor storage. A transaction-processing program is loaded 
on demand; that is, when a transaction that it processes is entered. You can write 
the program to terminate when it has completed its work or when it is told to 
terminate because another program needs storage. The program dispatcher uses a 
high-speed loader to load programs, so it is feasible to segment 
transaction-processing applications into small programs that occupy storage only 
while they have work to do. 

When the program dispatcher receives a transaction in the cell where it is to be 
processed, it finds the primary transaction identifier in its transaction table and 
proceeds according to the specifications in that entry. The entry includes the name 
of the program that is to process the transaction and its type. The type indicates 
whether or not the program dispatcher is to create a station block to represent the 
program, send the transaction to the station created, or load the program. 



Creating a Station Block 



Jp^y^ 



You can define a transaction that simply causes a program to be loaded, and that 
program may or may not send and receive messages. Alternatively, the program 
can receive the transaction itself as a message and process the transaction. 

If the program does process its transactions, or if it sends and receives messages, it 
must have an associated station block and message queue. The program name 
specified in the transaction table entry is also the station name. 

When the program dispatcher is to create a station block and the station block 
doesn't already exist, it is created in one of two ways. If the station is defined in 
$.SYSNET (the network configuration data set), the program dispatcher issues a 
start command for the station. The start command processor creates a station 
block; opens the station's disk queue, if it has one; and loads the program, if the 
station type is user (the type generally used to represent a program). If the station 
is not defined in $.SYSNET, the program dispatcher creates a station block with 
station type "message" and station name the same as the name of the program. 



Sending the Transaction Message 



The program dispatcher sends the transaction to the transaction-processing 
program if the transaction table entry so specified. The send causes the transaction 
to be placed on the message queue of the station that represents the program. 
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Loadii^ the Transaction-Processii^ Program 

if '\ 
You can define transactions that cause a program to be loaded each time a \^ ^ 

transaction is entered. You should do this only for programs that terminate 
execution after doing the work required for one transaction. 

You can define transactions that don't cause a program to be loaded. You might 
do this, for example, to accumulate a queue of transactions to be processed later by 
a program that you load yourself. 

What you will usually specify is that the program is to be loaded if it is not aheady 
in storage. It may have been loaded for a previous transaction and still be in 
storage, or it may have been loaded for this transaction by the start command, as 
discussed in the section "Creating a Station Block" on page 31. 

The program dispatcher does not use the EDX loader ($LOADER). It uses a 
high-speed loader distributed with the Communications FaciUty, which resides in 
the system storage pool (S$POOL). When the program dispatcher is started, it 
determines the location and size of each transaction-processing program, and saves 
that information in the transaction table. Therefore, the high-speed loader doesn't 
need to search directories for the programs it loads. 

If the programs the high-speed loader loads have overlays or data sets, they must 
be prefound. You can specify that the program dispatcher is to do this when it is 
started, or you can use the EDX utility $PREFIND to do it. Because the 
high-speed loader is resident, the amount of storage required to load a program is 
just the storage the program itself occupies. 



Rerouting Transactions 



The program dispatcher uses the high-speed loader to load the 
transaction-processing program into the partition you specify. If the load fails 
because there isn't enough storage, the program dispatcher tells an active 
transaction-processing program to terminate execution, waits 200 miUiseconds, and 
retries the load. It performs this retry procedure 30 times or until the load 
succeeds. After each ten attempts, it receives and processes any transactions on its 
message queue before retrying the load. You can use the PD RC (set retry counts) 
command to alter the number of load attempts. You can also specify, for individual 
transactions, that the load is to be retried until it succeeds or until the program 
dispatcher is shut down. 

When there is not enough storage to load a program, only those programs that you 
have designated as purgable are told to stop. 



A transaction table can contain reroute entries, as well as transaction definition 
entries. A reroute entry contains a transaction identifier and the identifier of the 
cell where the transaction is to be processed. You can use reroute entries to 
change the routing of transactions without changing their content. 

Suppose, for example, that you have a multicell configuration and an application 
where transaction PRTl is processed in cell CI. The transaction's primary cell 
identifier is CI, and the transaction table in cell CI has an entry that defines 
transaction PRTl. To cause PRTl transactions to be processed in cell C3, replace 
the PRTl definition with an entry that reroutes PRTl to cell C3, and add a PRTl 
definition to the transaction table in cell C3. 
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Controlling Transaction Flow 






Transactions flow according to the transaction, path, and reroute entries you 
define. While the program dispatcher is active, you can issue PD commands that 
change the flow. You can insert or delete path and transaction table entries, and 
hold transactions. All of these actions affect only the path table and transaction 
table in processor storage. To make permanent changes, you must modify the 
$.SYSPD data set from which these tables are built. 

You use the PD I (insert) command to add an entry to a path or transaction table 
and the PD R (remove) command to delete an entry. You can't add entries to a 
table unless you reserved space for them with your $.SYSPD definitions. 

You use the PD P (stop) command to inactivate a path or transaction table entry 
and the PD S (start) command to activate an entry, A transaction is undeliverable 
if its transaction definition is inactive or if a path over which it is to be routed is 
inactive. 

Holding transactions is the most useful method of controlling transaction flow. If 
there is a problem with a transaction-processing program or with a communication 
path, you can hold transactions until the problem is corrected, and then release 
them for processing. You use the PD F (modify) command to set or release a hold 
on a path or transaction. 

When the program dispatcher finds that a path to a cell is on hold, it creates a 
station named $.PHxjc (where xx is the cell identifier) and sends the transaction 
and all subsequent transactions for that path to station S.PHjcx. 

When the program dispatcher finds that a transaction is on hold, it creates a station 
named S.PHjcjcxx (where xxxx is the transaction identifier) and sends the 
transaction and all subsequent transactions with that identifier to station $.PHx;xa:a;. 

When you release a held path or transaction, the program dispatcher receives 
transactions from the appropriate $.PH station's message queue, processes them, 
and deletes the station block. 



Undeliverable Transactions 



For various reasons, the program dispatcher may be unable to deliver a transaction. 
It handles undeliverable transactions in various ways, depending on why it can't 
deliver the transaction. The program dispatcher may dispose of an undeliverable 
transaction in these ways: 

Alternate: The transaction is sent to the origin station's alternate link, if it has one 
and the alternate link station is started. You use $.CONFIG or the CP LINK 
command to define alternate links. This type of connection between stations is 
called an alternate link vector. 

$.UP: The program dispatcher issues an EDX LOAD instruction for program 
S.UPjcxxx, where xxxx is the transaction identifier. It doesn't send the transaction 
to the program; rather, it discards the transaction. Neither does it create a station 
to represent the program. This facility simply makes it possible for you to load 
programs in response to transactions without having defined the transactions. If 
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you don't need this capability, you can use the PD UP (user program) command to 

disable it. 'f' ^ 

$. WASTE: The transaction is sent to $. WASTE (the station for undeliverable 
messages), if $. WASTE exists. 

Discard: The transaction is discarded. 

The rest of this section lists reasons why transactions are undeliverable, and tells 
which dispositions are attempted, in chronological order. 

• The transaction is not a 3270 data stream, and is less than 6 bytes long. 
Disposition is alternate, $. WASTE, discard. 

• The transaction is a 3270 data stream that contains only 3270/BSC control 
information; it contains no data. These short data streams result from a 
terminal operator's pressing the CLEAR key or a PA key. Disposition is 
alternate, $. WASTE, discard. 

• The program dispatcher can't route the transaction to the cell where it is 
intended to be processed. Either the path is not defined and there is no 
preferred path, or the path is defined but the path table entry is inactive. 
Disposition is alternate, $. WASTE, discard. 

• The path is known and active, but the path station isn't started. Disposition is 
discard. 

• The transaction is in the cell where it is to be processed, but its transaction U J 
identifier is not defined in the transaction table. Disposition is alternate, $.UP, 

$. WASTE, discard. 

• The transaction is defined in the transaction table, but the entry is inactive; or 
the transaction-processing program can't be loaded. Disposition is $. WASTE, 
discard. 



Tracing and Testing Transactions 



During application program development or problem analysis, you may need a 
record of all transactions processed by the program dispatcher. You may also need 
to execute transaction-processing programs under control of the EDX $DEBUG 
program. The program dispatcher includes these facilities; they're described in the 
Programmer's Guide. 



Program Dispatcher Station Definitions 



You must define some stations for the program dispatcher's use in $.SYSNET, the 
network configuration data set. The stations you must define are the path stations 
and the station that represents the program dispatcher itself. Define the program 
dispatcher station with name $.PD and type "user." 

You need to define a station to represent a transaction-processing program only if 
you want the station to have a disk queue or you want its type to be other than 
"message." If you define the station in $.SYSNET because it has a disk queue, give 



^ w 
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it type "message." Then the start command processor will create the station block 
and open the disk queue, and the program dispatcher will load the program. If you 
define the station as type "user" (the type generally used to represent a program), 
then the start command processor will load the program; it may or may not be 
loaded into the partition you specified in the transaction definition, and you lose 
the benefits of the high-speed loader. 

The transaction-processing program does not always have to be a program. The 
"program" name you specify in the transaction definition can be the name of a 
station of any type; for example, it might be the name of a station that represents a 
terminal. If you define transactions so that they are routed to terminals, be sure to 
specify a transaction type that doesn't cause the program dispatcher to try to load a 
program. 

If you plan to hold transactions and you want a hold station to have a disk queue, 
define it in $.SYSNET as having type "message." Hold stations are those whose 
names begin with $.PH, as discussed under "ControUing Transaction Flow" on 
page 33. 

If you define transaction-processing program stations or hold stations in 
$.SYSNET, do it before you start the program dispatcher. The program dispatcher 
determines whether or not these stations are defined in $.SYSNET when it is 
started, not when it needs to use the stations. 



Starting the Program Dispatcher 



^^'*\ 
^^^j,^ 



You start the program dispatcher by starting the station that represents it, $.PD. 
When the program dispatcher is started, it loads the high-speed loader into the 
system storage pool and reads and processes its data set, $.SYSPD. The data set 
can contain commands, path table definitions, transaction table definitions, and 
transactions. 

In the first part of $.SYSPD, you can place any commands you want to be executed 
when the program dispatcher is started — for example, commands to start the 
stations that represent physical connections between cells. The program dispatcher 
sends the commands to the command processor. 

The program dispatcher builds its path table from the definitions in the second part 
of the data set. It issues a start command for each path station and sets a Unk for 
it, if one is required. If the path station represents an SNA logical unit or an 
emulated or real 3277 terminal, messages it sends are undeUverable unless it has a 
direct link. The program dispatcher links these types of path stations to its own 
station, $.PD. 

The program dispatcher builds its transaction table from the definitions in the third 
part of the data set. It determines the location and size of each 
transaction-processing program and, if you so specified, prefinds the program's 
data sets and overlays. 

In the fourth part of the data set, you can place any transactions that you want 
issued when the program dispatcher is started. 
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Shutting Down the Program Dispatcher 



You can shut down the program dispatcher and the programs it manages by halting 
station $.PD. The program dispatcher tells each of the programs defined in its 
transaction table to halt, frees the storage occupied by the high-speed loader, 
deletes its own station block, and terminates execution. 



If you stop station $.PD, the same actions occur except that the program dispatcher 
doesn't tell the programs it manages to stop. 



Communications Facility Transaction-Processing Programs 



System Transaction 



Transaction-processing programs provide some of the services available with the 
Communications Facility. Those programs run under control of the program 
dispatcher. 



The system transaction (SYST) performs a variety of functions, which are 
summarized in Figure 13. The program dispatcher uses some of these transactions 
to process PD commands. You can use any of them. 



Transaction 


Activity 


SYST CP 


Send a command to a cell 


SYST HL 


Load a program 


SYST ID 


Check whether a cell is active 


SYST MS 


Send a message to an EDX terminal 


SYST RC 


Set retry counts for program load 


SYST RH 


Release a held transaction or path 


SYST SP 


Start a remote disk 


SYST ST 


Check whether a station exists 


SYST TI 


Set the system time and date in a cell 


SYST TR 


Start or stop a trace of transactions 


SYST WH 


Check whether a program is loaded 


SYST UP 


Set user program ($.UPjcjcxjc) load mode 



\^ 



Figure 13. Summary of SYST Transactions 

The program dispatcher itself ($.PD), rather than a separate program, processes 
the SYST transactions. The Operator's Guide gives the syntax and an example of 
each SYST transaction. 
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Transaction Scheduler 



The scheduler transaction (SCHD) schedules transactions for later processing. 
You can schedule a transaction to be processed once or repeatedly, at a specific 
time of day or at a specific time interval. 

The program $.PDSCHD provides transaction scheduUng. The Operator's Guide 
gives the syntax and an example of the SCHD transaction. 



Remote Management Fmictions 



Remote IPL 



The Communications Facility includes a set of functions that help you manage 
remote Series/ Is in your configuration. You can allocate and delete data sets, send 
and receive data sets, execute programs, dump storage to disk, and use a local 
terminal as if it were connected to a remote Series/ 1. 

These functions are provided by a pair of programs that exchange transactions. 
The program that runs in the remote Series/ 1 is $.RMU (remote management 
utiUty). The program that runs in the system from which the functions are 
requested can be either $.HMU (host management utility) or Communications 
Facility/Host. 

$.HMU runs on a Series/ 1. It can communicate with $.RMU in another Series/ 1 
over any of the connections the Communications Facility supports — BSC 
multipoint, BSC point-to-point. Local Communications Controller, and HDLC. 
$.HMU and $.RMU are provided as part of the Communications FaciUty. They 
are described in the Operator's Guide. 

Communications Facility /Host runs in a System/370, a SOxa;, or a 4300. It can 
communicate with $.RMU only over a BSC multipoint Une or an SDLC line (an 
SNA connection). Communications Facility /Host is a licensed program 
(5668-979). It is described in Communications Facility/ Host: General Information 
Manual. 

The path between the remote Series/ 1 and either type of host system can be used 
by application programs while remote management functions are going on. 



The IPL transaction IPLs an EDX supervisor at a remote Series/ 1. The 
connection between the Series/ 1 where the IPL transaction is processed and the 
Series/ 1 to be IPLed can be BSC multipoint, BSC point-to-point, or Local 
Communications Controller. It cannot be an HDLC line. 

There are two restrictions: 

• When the connection is a BSC line, the attachment at the Series/ 1 to be IPLed 
must be a BSC single-line control (feature number 2074 or 2075) or a 
multifunction attachment (feature number 1310). 

• When the connection is a BSC multipoint line, the Series/ 1 to be IPLed must 
be the tributary. 
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There are several types of remote IPL. One type sends a bootstrap and then a 
nucleus to the Series/ 1 to be IPLed. The nucleus (the EDX supervisor) must ff"\ 

contain support for the Communications FaciUty language extensions. Two \^ 

restrictions apply to this type of remote IPL: 

• The segment of the nucleus that resides in partition 1 must not exceed X'FEOO' 
in size. Use the EDX utiUty, $DISKUT2, to determine the size of the nucleus. 

• When the connection is a BSC point-to-point line, you must not send any 
messages (including broadcast transactions) to the remote Series/ 1 before 
doing the IPL, unless there is already an operating lOCP ($.IO0A10) to 
receive the messages. 

The other types of remote IPL send just a bootstrap to the Series/ 1 to be IPLed. 
The bootstrap causes the Series/ 1 to be IPLed from one of these devices: 

4950 disk at address X'03' 
4956 IDSK disk at address X'60' 

4962 disk at address X'03' 

4963 disk at address X'48' 

4964 diskette at address X'02' 

4965 diskette at address X'45' 

4966 diskette at address X'22' 

4967 disk at address X'CO' 
5170-495 disk at address X'03' 
DDSK-30 and DDSK-60 disk at address X'44'. 



There are two ways of initiating a remote IPL. One is to issue an IPL transaction (^ 

at a Series/ 1 where the program dispatcher is running. The other (called a 



hardware IPL request) is to press the load button at the Series/ 1 to be IPLed. 



A hardware IPL request can be used only at a Series/ 1 with a Local 
Communications Controller attachment that is strapped as the IPL device. The 
hardware IPL request is transmitted to all other Series/ Is on the Local 
Communications Controller ring. The Series/ 1 that is enabled to respond to the 
IPL request issues an IPL transaction (any of the types described earlier) that 
causes the Series/ 1 where the load button was pressed to be IPLed. 

A Series/ 1 is enabled to respond to a hardware IPL request when all these 
conditions hold: 

• The Communications Facility, the lOCP that manages the Local 
Communications Controller ($.IO0AB0), and the program dispatcher are all 
active. 

• The station representing the Series/ 1 where the load button was pressed is 
active. 

• The program dispatcher transaction table contains an entry for transaction 
identifier IPL. 

• The IPL transaction data set ($.SYSLCC) contains an entry for the Series/ 1 

that requested the IPL. ^"^ 
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Remote Disk Support 






Each entry in data set $.SYSLCC contains the name of a station that represents a 
remote Series/ 1 and the IPL transaction used to IPL that Series/ 1 . When you 
create $.SYSLCC data sets, be careful to enable one and only one Series/1 to IPL 
each Series/ 1 that will issue hardware IPL requests. If there is none, the hardware 
IPL request is ignored. If there is more than one, the results are unpredictable. 

The program $.PDIPL provides remote IPL. The Operator's Guide gives the syntax 
and an example of the IPL transaction. In this book, the chapter "Communications 
Facility Data Sets" on page 179 explains how to create $.SYSLCC, and the 
chapter "Sample Configurations" on page 269 contains an example of a 
$.SYSLCC data set. 



Remote disk support allows programs to access disk volumes attached to remote 
Series/ Is just as if they were attached to the local Series/ 1. The volumes must be 
performance volumes. No special programming is required to use remote disk. The 
EDX I/O instructions to access remote disks are the same as those used to access 
local disks. Two programs, CSPDIO and $.PD<IO>, provide remote disk support. 

CSPDIO is a module included in the EDX supervisor for Series/ Is that access 
remote disks. CSPDIO must be placed between CSXSYS and $EDXDEFO in the 
static section of the supervisor. You must define remote disk volumes and the 
communication path used to access them to the EDX supervisor, as explained in 
the chapter "Installing the Communications Facility" on page 251. CSPDIO 
intercepts any I/O request to a remote disk, builds a transaction, and sends it to the 
Series/ 1 where the disk is located. 

$.PD<IO> is a transaction-processing program that runs in Series/ Is where 
remote disks are located. It receives the transactions that CSPDIO issues, performs 
the requested I/O, and sends back a transaction that contains the result. CSPDIO 
passes the result to the program that issued the I/O request, just as EDX disk I/O 
support does. 

The connection between the Series/ 1 that accesses remote disks and the Series/ 1 
where the disks are located can be BSC multipoint, BSC point-to-point, or Local 
Communications Controller. It cannot be an HDLC line. 

You can't access remote disks until the program dispatcher is running in the 
Series/ Is where the disks are located. Neither the Communications Facility nor 
the program dispatcher has to be running in Series/ Is that access remote disks. 

CSPDIO uses two different ways of sending disk I/O transactions, depending on 
whether or not the program dispatcher is running. When the program dispatcher 
isn't running, CSPDIO sends transactions over the path you define to the EDX 
supervisor. 

There are three restrictions: 

• You can define only one path to remote disks. 

• When the path is a BSC multipoint line, the Series/ 1 that accesses remote disks 
must be the tributary. 
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• The BSC line or the Local Communications Controller connection can be used 
only by CSPDIO. You can start the lOCP that manages the line, but it can't 
access the line. 

These restrictions are removed when you start the program dispatcher and issue a 
SYST SP (start remote disk) transaction. You can include the SYST SP transaction 
in the program dispatcher's data set ($.SYSPD). The transaction causes CSPDIO 
to release control of the BSC line or Local Communications Controller connection 
and to send disk I/O transactions to the program dispatcher. Thereafter, access to 
remote disks is by the paths defined in the program dispatcher's path table. 

Remote disk support provides no protection against concurrent update of a data 
set. You should use it only to retrieve data sets or to create or update data sets that 
are used exclusively by one program. If you have an application that requires 
shared data sets, you should write it so that programs send their disk I/O requests 
to a single program that performs the requested I/O. 



Work Session Controller 



The work session controller provides many terminal I/O and control services. It 
provides several techniques for transferring control from one program to another, 
which makes it easy to segment an application into multiple small programs. It 
enables programs to retrieve screen images from disk, save data associated with a 
particular terminal on disk, and retrieve saved data. 

An application program gets services from the work session controller by 
exchanging transactions with it. The program sends a WSC transaction that 
requests a particular service for a particular terminal. The work session controller 
receives the WSC transaction, performs the requested service, and sends an 
acknowledgment transaction. The acknowledgment transaction shows which 
service was performed for which terminal, and may (depending on the service) 
contain data or a return code. The program that issues a WSC transaction specifies 
where the acknowledgment is to be sent — it can be routed back to the same 
program or to some other transaction-processing program. 

The Programmer's Guide shows the format of all the WSC transactions and 
explains how to use them. 






The work session controller ($.WSC) provides a high-level terminal access method 

that you can use to write interactive application programs that communicate with 

EDX terminals. The work session controller supports communication with 4978, 

4979, 4980, and 3101 terminals and with 4973, 4974, 4975, 5219, 5224, 5225, 

and 5262 printers. The terminals and printers must be defined to EDX; they need 

not be defined as Communications Facility stations. An apphcation program can 

communicate with multiple terminals, which can be attached to any Series/ 1 in the 

network. /^ 



^' 
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Utility Programs 



The Communications Facility includes several utility programs. Some are used to 
install and maintain a Communications Facility system. Others are aids for 
application development. 



$.CFMENU, Sample Program 



$.CFMENU is a sample application program that serves two purposes. You can 
run the program to verify that you have installed the Communications Facility 
correctly, as explained in the chapter "Installing the Communications Facility" on 
page 251. $.CFMENU communicates with operators at Communications FaciUty 
terminals and illustrates many of the programming techniques that you may use in 
your application programs. The Programmer's Guide contains a discussion and 
Usting of the program. 



$. CONFIG, Configwation Processor 



You may use $. CONFIG to define stations in $.SYSNET (the network 
configuration data set), to modify and display existing station definitions, and to 
maintain $.SYSMSG (the log message data set). $. CONFIG is described in the 
Operator's Guide. 






$.DSFORM, Emulated PC Disk Management Utility 



You use $.DSFORM to create, delete, or rename data sets used as emulated 
Personal Computer (PC) disks. $.DSFORM is described in the Operator's Guide. 



$.DSINIT, Disk-Queue Data Set Initialization 



You use $.DSINIT to initialize data sets that are to be used as disk queues. 
$.DSINIT is described in the Operator's Guide and in this book, in the chapter 
"Creating Disk-Queue Data Sets" on page 207. 



$.PANEL, Panel Design Aid 



You use $. PANEL to create panels that your application programs display. A 
panel is a screen image for a Communications Facility terminal, either a 3277 or a 
4978, 4980, 3101, or 7485 being managed as if it were a 3277. The Programmer's 
Guide describes $. PANEL. 



$.PNLUT1, Panel Utility 



You use $.PNLUT1 to print the descriptions of panels created by $. PANEL. The 
Programmer's Guide describes $.PNLUT1. 
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$.PDBSTS, Volume Protection 

I 1 
$.PDBSTS allows you to gain exclusive control of a disk- volume directory in a ^— ' 

remote Series/ 1 before executing a program that would update that directory. You 

might use it, for example, before running EDX utility $DISKUT1 to allocate a data 

set on a remote disk volume. $.PDBSTS is described in the Operator's Guide. 

$.SETSTG, Set $.CFD Storage Size 

You use $.SETSTG to alter the size of the message buffer pool and the file control 
block pool for $.CFD, the disk-queuing version of the Communications Facility 
control program. $.SETSTG is described in the Operator's Guide. 

You use the EDX utility $DISKUT2 to alter the size of the message buffer pool for 
$.CFS, the storage-queuing version of the control program. 

$.UT1, Diagnostic Aid 

You can use $.UT1 to diagnose Communications Facility problems and to test your 
application programs. You can use it to manage stations, send and receive 
messages, display the system storage pool and message buffer pool, and get the 
addresses of various system control blocks. $.UT1 is described in the Operator's 
Guide. 

$.UT2, Message Queue Management /f > 

You can use $.UT2 to obtain a report of messages in a disk queue or to purge 
messages from a disk or storage queue. When you purge messages, you can also 
get a report of them, and you can send each message on to the destination you 
specify. You can use most $.UT2 functions with any station's message queue. A 
few can be used only with the undeliverable message queue, $. WASTE. $.UT2 is 
described in the Operator's Guide. 

$.WSCUT1, Image Library Management 

Screen images displayed by the work session controller are stored in data set 
$.WSCIMG. You use the EDX utility $IMAGE to create screen images. You use 
$.WSCUT1 to convert the images to the format required by the work session 
controller and to store them in $.WSCIMG. You can also use $.WSCUT1 to 
display stored images. $.WSCUT1 is described in the Programmer's Guide. 



$.WSMENU, Work Session Controller Sample Program 



You can use $.WSMENU to start communication between an EDX terminal and 
work session controller application programs. $.WSMENU is described in the 
Programmer's Guide. 



\^ 
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User-Written Programs 






You may want to supplement the Communications Facility's functions by adding 
your own programs to: 

Process undeliverable messages 
Process system log messages 
Intercept messages sent by lOCPs 
Provide support for devices 
Provide new commands 
Communicate with operators at terminals. 

Language and Assembler Considerations 

Regardless of what function a program provides, you can code it in EDL or in 
assembler language, using the language extension instructions to obtain 
Communications Facility services. The instructions are provided in two forms — as 
overlays for the EDL compiler ($EDXASM) and as macros for the Series/ 1 macro 
assembler ($S1ASM). 

Coding Interactive Programs 

There are two ways of writing programs to communicate with terminal operators: 

• Exchanging 3270 data streams with an lOCP that manages Communications 
FaciUty terminals. 

• Exchanging WSC transactions with the work session controller, which manages 
EDX terminals. 

You can write almost any interactive program either way. Here are some factors 
that you need to consider when you decide which method to use. We'll refer to the 
first method as 3270DS and the second as WSC. 

In support of 3270DS, the Communications Facility provides utility program 
$. PANEL for building screen images and language extension instructions for 
building 3270 data streams and extracting information from them. 

It's important to consider the type of terminal you'll be communicating with. Only 
3270DS allows communication with 3277 and 7485 terminals, and only WSC 
allows communication with 4979 terminals. Both methods support printers, 4978s, 
4980s, and 3101s. WSC supports 3101s in both character and block mode; 
3270DS supports them only in character mode. 

The processor storage required for EDX control blocks, station blocks, and 
programs may be a consideration. If you're using 3101 terminals with WSC, you 
have to define them to EDX; if you're using them with 3270DS, you don't. 

The work session controller creates station blocks for the terminals it manages. 
These station blocks are larger than those for terminals managed by lOCPs. (The 
sizes of all types of station blocks are given in the chapter "Planning Storage 
Requirements" on page 213.) 
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The size of the work session controller is approximately 12K, and the size of the 
program dispatcher (which is required for WSC) is approximately UK. The 
various lOCPs that manage terminals range in size from lOK to 25K. (See the 
chapter "Planning Storage Requirements" on page 213 for exact sizes.) You can 
use the program dispatcher with 3270DS, but you don't have to; if you have a 
multinode configuration, you probably will. 

If your application includes communication with a host system, and if the host 
system requires 3270 data streams, you may find it easier to communicate with 
terminals the same way. 



o 



Managing a Multinode Configuration 



If your configuration consists of more than one node, you may want to designate 
one of the nodes as a central site from which you manage the operation of the 
other nodes. Although the Communications Facility is a peer-to-peer system, it 
does provide many facilities that you can use for centralized management. This 
section summarizes those facilities; most of them have already been discussed in 
this chapter. 

You can IPL a remote node, sending either a bootstrap or a bootstrap and a 
nucleus. You can set up a node so that the Communications Facility is started 
automatically at IPL, and so that startup commands (commands to set the log 
device, start stations, etc.) are issued automatically. The chapter "Operating the 
Communications Facihty" in the Operator's Guide explains how to set up a node 
this way. 

The remote management utility programs ($.HMU and $.RMU) allow you to 
allocate and delete data sets, send and receive data sets, execute programs, dump 
storage to disk, and use a local terminal as if it were connected to a remote 
Series/ 1 . 

The program dispatcher allows you to send commands to a remote node. The 
operator at the central site can issue commands to start and stop stations in remote 
nodes. 

Although the Communications Facility doesn't provide a central system log, it's not 
difficult to write a program that receives log messages at remote nodes and sends 
them to the central site. The Programmer's Guide explains how to code such a 
program. 

Remote disk support allows programs running in remote nodes to access disks at 
the central node. The remote nodes can be diskless systems. It is recommended, 
but not required, that each node have a diskette drive. 

You can use the remote command and transaction scheduUng functions of the 
program dispatcher to shut down nodes (including the central node) when no 
operator is present. The chapter "Operating the Communications Facility" in the 
Operator's Guide explains how to do this. 



o 
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Defining Stations 



For each node in your Communications Facility system, you must define all the 
local stations (stations in that node) and remote stations (stations in other nodes) 
to which local stations will send messages. When you define a station, the 
information is recorded in $.SYSNET, the network configuration data set. There is 
one $.SYSNET data set for each node. 



Station Types 



A Communications Facility configuration is dynamic; you can add new station 
definitions and change existing ones at any time. 

To define stations, you can use either the utility program $.CONFIG or the CP 
DEF command, which are described in the Operator's Guide. This chapter 
describes the various types of stations and the information you specify to define 
them. The chapter "Sample Configurations" on page 269 shows the station 
definitions for several Communications Facility configurations. 



Line Station 



Circuit Station 



The following sections describe the various types of stations supported by the 
Communications Facility. 



A line station represents a Series/ 1 communication link. The link may be a Local 
Communications Controller ring, a Series/ 1 -PC Connect Attachment, a channel 
attachment to a host computer, a binary synchronous communication (BSC) line, 
or an PIDLC line. A BSC line may connect to a 3270 system, a host computer that 
views the Series/ 1 as if it were a 3270 system, another Series/ 1, or some system 
that uses point-to-point protocol. 

lOCPs manage communication over lines. A line station block contains or points 
to its associated task control block. The TCB is used with reentrant code in the 
lOCP. 



A circuit station represents an X.25 virtual circuit (channel) — either permanent or 
switched. Circuit stations are used for sending and receiving messages over HDLC 
lines to another Series/ 1 or through an X.2S network. 
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When you define a circuit station, you specify the name of its associated line 
station. The line station task, which is part of an lOCP, manages communication 
with the circuit station. 



SNA Physical Unit (PU) and Logical Unit (LU) Stations 



Node Station 



SNA stations are used for communication with a host computer over a synchronous 
data link control (SDLC) line. The host computer views the Series/ 1 as if it were a 
3274-SDLC control unit with attached display stations and printers. 

An SNA LU station represents an emulated display station or printer. When you 
define an SNA LU station, you specify the name of an SNA PU station, which is 
used to hold information common to all its SNA LU stations. You can define up to 
four PU stations in a node. EDX Secondary SNAl allows you to define only one 
PU station in a node. EDX Secondary SNA2 allows you to define up to four PU 
stations in a node. 

An lOCP manages communication with SNA stations. An SNA LU station block 
contains or points to a task control block that is associated with reentrant code in 
the lOCP. 



A node station represents a remote node accessible from a Local Communications 
Controller ring, a Series/ 1 -PC Connect Attachment, a BSC point-to-point line, or 
an HDLC line. The local and remote nodes may be connected to each other, or 
there may be intermediate nodes or an X.2S packet-switching network between 
them. 

When you define a remote node that is connected to the same Local 
Communications Controller ring as the local node, you specify the name of the 
Local Communications Controller line station. The line station task, which is part 
of an lOCP, manages the node station. The node station is used to hold messages 
being sent to the remote node, and should be defined with subtype CF or CM. 

When you define a remote node that is connected to the same Series/ 1 -PC 
Connect Attachment as the local node, you specify the name of the Series/ 1 -PC 
Connect Attachment line station, and the name of the associated volume station, if 
needed. The PCC line station task, which is part of the lOCP, manages the node 
station. The name of the volume station is used to route messages to the PC 
Connect disk-server lOCP, $.I01CC8. The node station is used to hold messages 
being sent to the gateway PC and should be defined with subtype PC. 

When you define a remote node that is accessible in some other way, you do not 
specify the name of any associated station. Instead, you must link the node station 
to the station that represents the path to the remote node, as explained in section 
"Linking Stations" on page 65. The station you link to receives the messages 
being sent to the remote node. 
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Device Station 



A device station represents a device attached to a Series/ 1. The device can be an 
IBM: 



Volume Station 



4978 terminal 

4980 terminal 

3101 terminal 

3161 or 3163 in 3101 emulation mode 

7485 terminal 

Personal Computer emulating a 3101 

Series/ 1 printer. 



lOCPs manage communication with device stations. A device station block 
contains or points to its associated task control block. The TCB is used with 
reentrant code in the lOCP. 



A volume station represents an EDX volume that contains data sets representing 
emulated PC disks. An lOCP, $.I01CC8, manages communication with volume 
stations. Each volume station has a task control block that is associated with a 
reentrant task in the lOCP. 



User Station 



A user station represents a program. It may represent a user application program 
or a Communications Facility program, such as an lOCP or the program 
dispatcher. 

Not every program that uses Communications Facility functions needs a station, i 
station is required if any of these conditions holds: 

• Messages are sent to the program. 

• The program requests acknowledgment of the messages it sends. 

• You want to use a CP command to stop the program. 



Message Station 



O 



A message station is just a station block with a message queue; it doesn't 
necessarily represent anything. The station that receives undeliverable messages, 
$. WASTE, may be a message station. The program dispatcher creates message 
stations for transaction-processing programs. Your application programs can 
create message stations to be used however you want. 

Message stations can serve the same purpose as user stations by supplying a station 
block and a message queue for a program. The difference between the message 
station and the user station is what happens when they are started. Starting a user 
station causes the program with the same name as the station to be loaded. 
Starting a message station doesn't cause a program to be loaded. 
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Teiminal Station 



A terminal station represents either a real 3270 terminal connected to a Series/ 1 
with a BSC line, or an emulated 3270 terminal. Emulated 3270 terminals are just 
station blocks with message queues that are used for communication with a host 
computer over a BSC line or a channel. 

When you define a terminal station, you specify the name of its associated line 
station. The line station task, which is part of an lOCP, manages communication 
with the terminal station. 



Remote (Vector) Station 



A remote station represents a station in another node. ''Remote" is not a station 
type in the sense of other station types described in this section. A station is 
identified as remote by its network address, not by its type. You can specify 
whatever tjrpe you want when you define a remote station. 

When a station is started and its network address shows that it is a remote station, 
a vector station block is created. A vector station block contains only the station's 
name, network address, link, and status. Any other information in the station 
definition is ignored. 



Alias Station 



An alias station defines an alias name for another station. You can, for example, 
define XYZ as an alias for station ABC. Each time you refer to XYZ, you are 
actually referring to station ABC. 



System Station 



Other Stations 



There is only one system station. Its name is $.DISP. It is used by various 
Communications Facility tasks. 

You don't define the system station. The $.DISP station block is created when you 
IPL an EDX supervisor that supports the Communications Facility. 



There are additional types of stations supported by the Manufacturing Automation 
Protocol Application Server (program nimiber 5719-XTl): a link-level service 
access point (LSAP) station and a line station that represents a link to a network 
interface unit (NIU). 
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TNL SN23-8600 (27 March 1987) to SL23-0104-2 



O Identifying Nodes 



You identify a node by a 2-digit hexadecimal value called a node assignment. 

If you have a single-node configuration or a multinode configuration where the 
only connections between nodes are BSC multipoint lines, the node assignment can 
be any value from X'OO' to X'FF'. 

If you have a multinode configuration where the connection between nodes is a 
Local Commimications Controller ring, a BSC point-to-point line, or an HDLC 
line, each node must have a unique node assignment in the range X'Ol' to X'FF'. 

The program dispatcher creates station blocks for stations that are not defined in 
$.SYSNET. Other programs, including those you write, may also do this. The 
network address of these stations is the address of the station block in S$POOL. 
To avoid having duplicate network addresses, do not use node assignments that fall 
within the range of S$POOL addresses. For example, if you have a 6000-byte 
S$POOL that extends from address X*057E' through X'lCEE*, do not use X*05' 
through X'lC as node assignments. 



,C 
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If your configuration includes Communications Manager or gateway PC nodes, 
there are special requirements for identifying nodes to both systems. The 
Communications Manager and the PC Connect use a 2-character alphabetic name 
to identify nodes instead of a hexadecimal node assignment. Specify a repeated 
letter (for example, AA) as the Communications Manager or the gateway PC node 
name. Specify the hexadecimal representation of the letter as the Communications 
Facility node assignment — for example, X'Cl'. 



Identifying Stations 

A station has two identifiers — a name and a network address. 

The station name consists of 1 to 8 alphanumeric characters. If your configuration 
includes Communications Manager or gateway PC nodes, stations that will send 
messages to or receive messages from the Communications Manager or the PC 
Connect must have names no longer than four characters. If your configuration 
includes a volume station, the volume station name must be no longer than six 
characters and must be the same as the EDX volume that it represents. If your 
configuration includes an HDLC Une, the line station name must be no longer than 
six characters and must match the name of the Une you defined to XHCS. Each 
station in a node must have a unique name. Stations are referred to by their names 
in commands, utility programs, and language extension instructions. 

The network address consists of four hexadecimal digits. The leftmost two digits are 
the node assignment of the node in which the station exists. The rightmost two 
digits, called the station address, identify the station within the node. Each station 
in a node must have a unique station address. The required value, which varies 
according to the station type, is explained in the later sections of this chapter. The 
message dispatcher and other parts of the Communications FaciUty refer to stations 
by their network addresses. 



Configuration Worksheets 



This chapter includes five configuration worksheets that you can use to record the 
information that you will specify when you define stations. 

Figure 14 on page 51 is a worksheet for user, message, alias, and volume stations. 

Figure 15 on page 52 is a worksheet for device stations. 

Figure 16 on page 53 is a worksheet for line, terminal, and node stations. 

Figure 17 on page 54 is a worksheet for SNA stations. 

Figure 18 on page 55 is a worksheet for circuit stations. 

At the top of each configuration worksheet, fill in a description of the Series/ 1 (for 
your own documentation) and its node assignment. 
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For each station, fill in its description (for your own documentation) and its station 
name. The rest of the information, which varies according to station type, is 
explained in the following sections. 

The bottom of each worksheet includes space to record the amount of S$POOL 
storage that will be required for station blocks. Fill in the number of stations you 
defined and the total storage requirement. You can use this information when you 
determine the amount of processor storage your Communications FaciUty system 
will require, as explained in the chapter "Planning Storage Requirements" on 
page 213. 

If you use the disk-queuing version of the control program, you also need the 
disk-queue data set worksheet, which is in the chapter "Creating Disk-Queue Data 
Sets" on page 207. That worksheet includes information that you will specify 
when you define a station that has a disk queue. 

The disk-queue information you supply when you define a station is the name and 
volume of the station's disk-queue data set and whether or not disk queuing is to be 
active when the station is started. If you use $. CONFIG to define stations, the 
default volume is the one where $. CONFIG resides. If you use CP DBF, the 
default volume is the one where the Communications Facility control program 
resides. 



o 



Specifying Station Definitions 



This section explains how to fill in the station definition worksheets for each station 
type. It shows the headings on the worksheet and explains what to enter under 
each heading. Having completed the worksheets, you can use them as input when 
you use the $. CONFIG, CP DEF, or CP F command to define your stations. 






o 



50 Communications Facility Design and Installation Guide 






User /Message /Alias /Volume Configuration Worksheet 



System: 



Node Assignment: 



^|(,U>»' 



Description 


Name 


NA 


Type 


AUas' 































































































































































































































Specify only for alias station 



-User/Msg Stations 
-Alias Stations 



-Remote Stations 



S$POOL Storage 

x88 = , 
x40 = . 
X32 = . 



-Volume Stations 



X 104 = . 



. bytes 
. bytes 
. bytes 
_ bytes 



Figure 14. User/Message/ Alias/ Volume Configuration Worksheet 
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Device Configuration Worksheet 



System: 



Node Assignment: 



o 



Description 


Name 


NA 


Type 


Device Type 


Buffer 
Size 


FDS' 


Polling 
CUDA 


ill 


Bit Rate' 


Auto 
Ans' 








DEVICE 






















DEVICE 






















DEVICE 






















DEVICE 






















DEVICE 






















DEVICE 






















DEVICE 






















DEVICE 






















DEVICE 






















DEVICE 
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DEVICE 






















DEVICE 






















DEVICE 






















DEVICE 






















DEVICE 






















DEVICE 




















specify only for printer device station 

Specify only for printer or 4978 device station 

Specify only for 3101 or 31 OIF device station 

Specify only for 3101 F device station 

For 7485s, bit rate must be 9600 and AUTO ANS=NO. 



S$POOL Storage 



_3 101 F Devices 
_4978/Printer Devices 
-3101 Devices 
-Remote Stations 



X 160 = 

X 264 = 

X 304 = 

X 32 = bytes 



bytes 
bytes 
bytes 



Figure 15. Device Configuration Worksheet 
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Line /Terminal /Node Configuration Worksheet 



System: 



Node Assignment: 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address* 


Packet Size' 


Window' 








LINE 


















LINE 


















LINE 













Terminal and Node Definitions 






Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name* 


Polling 
CUDAV 

Portr 


Select 
CUDA' 







































































































































































































































































Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 

Specify only for Local Communications Controller node station 

Specify only for 3271, 3277, or 3286 terminal station 

Specify only for port terminal station 

Specify only for DCE or DTE line station 

Specify only for PC node station 



SSPOOL Storage 

-HDLC Lines xll2 = 

-Other Lines x 264 = 

-Terminals/Nodes x 88 = . 

-Remote Stations x 32 = . 



_ bytes 
_ bytes 
. bytes 
. bytes 



Figure 16. Line/Terminal/Node Configuration Worksheet 
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SNA Configuration Worksheet 



System: 



Node Assignment: 



PU Definition 



Description 


Name 


NA 


Type 


Buffer Size 


PU 


Host Application Host Mode 








PU 






#1: 


#2: 


#3: 



LU Definitions 



Description 


Name 


NA 


Type 


Term 
Type 


PU Name 


Local 
Address 


Logon ID 


User Data 








LU 


















LU 


















LU 


















LU 


















LU 


















LU 


















LU 


















LU 


















LU 


















LU 


















LU 


















LU 


















LU 













Valid only for EDX Secondary SNA2 



SSPOOL Storage 



1 Physical Unit x 128 = 128 bytes 

Logical Units x 280 = bytes 

Remote Stations x 32 = bytes 



Figure 17. SNA Configuration Worksheet 






xJ 
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Circuit Configuration Worksheet 



System: 



Node Assignment: 



PVC Circuit Definition 



Description 


Name 


NA 


Type 


Circuit Type 


Line 


Usage 


La 








CIRC 


PVC 














CIRC 


PVC 














CIRC 


PVC 














CIRC 


PVC 














CIRC 


PVC 









SVC Circuit Definition 



Description 


Name 


NA 


Type 


Circuit Type 


Line 


Usage 


Contact 


Can ID 


Packet Size 


Window 


Protocol ID* 


Facilities 


User Data' 








CIRC 


SVC 


























CIRC 


SVC 


























CIRC 


SVC 


























CIRC 


SVC 


























CIRC 


SVC 


























CIRC 


SVC 


























CIRC 


SVC 


























CIRC 


SVC 


























CIRC 


SVC 


























CIRC 


SVC 





















Specify only for contact type INIT or WAIT 
Specify only for contact type INIT 



S$POOL Storage 

-Circuits x 128 



. bytes 



Figure 18. Circuit Configuration Worksheet 
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Defining Line Stations 



NA 

is the 4-digit hexadecimal network address. The leftmost two digits are the node 
assignment. For a Local Communications Controller or Series/ 1 -PC Connect 
Attachment Une station, the rightmost two digits may be any value from 01 to 
FE that is unique within the node. For other types of line stations, the rightmost 
two digits must be the device address pinned on the attachment card that 
controls the device. It can't be 00; for a device with hardware address 00, 
specify FF. 

Type 
is LINE. 

Line Type 

is one of the following: 

PTPT, to define a BSC point-to-point line that connects the Series/ 1 to some 
other system. 

CPU, to define a BSC point-to-point Une that connects two Series/ Is. 

327 IC, to define a BSC multipoint line that connects the Series/ 1 to a 3270 
system (or to a Series/ 1 that emulates a 3270 system). 

327 IE, to define a BSC multipoint line that connects a Series/ 1 that emulates a 
3270 system to a host computer. 

LCC, to define a Local Communications Controller ring. 

PCC, to define a Series/ 1 -PC Connect Attachment. 

CA, to define a channel attachment. 

DCE, to define an HDLC Une where the Series/ 1 acts as data 
circuit-terminating equipment. This type must match the XHCS definition for 
the Une. 

DTE, to define an HDLC Une where the Series/ 1 acts as data terminating 
equipment. This type must match the XHCS definition for the Une. 

Buffer Size 

is the size of the buffer required for the station, as explained in the chapter 
"Planning Storage Requirements" on page 213. If you use $. CONFIG to define 
stations, specify a decimal value. If you use CP DEF, specify a hexadecunal 
value. 

Device Address 

is required only for a Local Communications ControUer or a Series/ 1 -PC 
Connect Attachment line station. Specify the Local Communications ControUer 
or PC Connect device subchannel address, as two hexadecimal digits. The 
value must be from 00 to FC and a multiple of 4. 
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Packet Size 

is required only for DTE and DCE lines. Specify the size of the largest user data 
area you intend to send on a data packet. The packet size must be one of the 
standard X.25 sizes and must agree with the IMAX parameter on the lines 
XHCS DDM. Packet size can be no larger than IMAX-4. If you are using an 
X.25 packet-switching network, the size must equal the size you subscribed to 
from the network. The line packet size is the default for all circuits on the Une. 

Window Size 

is required only for DTE and DCE lines. The line window size is the default for 
all the circuit stations on the line. If you are using an X.25 packet-switching 
network, the window size must equal the size you subscribed to from the 
network. 

X.25 Network Address 

is valid only for DTE and DCE lines. If you are using an X.25 packet-switching 
network that requires the calling address on the call request packet, use 
$. CONFIG or the CP F ADDR command to specify the X.25 network address 
in the line station definition. 



Defining Circuit Stations 



o 



NA 

is the 4-digit hexadecimal network address. The leftmost two digits are the node 
assignment. The rightmost two digits may be any value from 01 to FF that is 
unique within the node. 

Type 

is CIRCUIT. 

Circuit Type 

is one of the following: 

PVC, to define a permanent virtual circuit. 

SVC, to define a switched virtual circuit. You may specify SVC only if the 
associated line station type is DTE. 

Line Name 

is the name of the associated DCE or DTE line station. You must define the line 
station before you can define the circuit stations. 

Usage 

is one of the following: 

CF, if the circuit is used to route messages with their Communications Facility 
headers between Series/ Is. 

STD, if the circuit is used just for passing data. 

STD+, if the circuit is used for passing both data and X.25 control information. 



o 
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Packet Size 

is the 1- to 4-digit decimal size of the maximum user data field required for a 
data packet. If the circuit is used to send messages through an X.25 network, 
the packet size must be the one subscribed to from the X.25 network. Specify 
16, 32, 64, 128, 256, 512, or 1024. 

You must use CP F PKTSIZ command to add the packet size to the circuit 
definition. If you do not specify this parameter, the controUing line station's 
packet size is used. 

Window Size 

is the number of packets that can be sent before an acknowledgment is expected. 
Specify a decimal number from 1 to 127. You must use CP F WINDOW 
command to add the window size to the circuit definition. If you do not specify 
this parameter, the controUing line station's window size is used. 

The following parameter is for PVC circuits only. 

LCI 

is the logical channel identifier for a PVC circuit. Specify a decimal number 
from 1 to 4095. This logical channel must be defined to XHCS for use as a 
PVC. If you are using an X.25 packet-switching network, the channel must be 
subscribed for use as a PVC. 

The following parameters are for SVC circuits only. 

Contact ^"x 

describes the action the lOCP is to take when the circuit station is started. i, ) 

Specify one of the following: ^-^ 

WAIT, if the circuit is to wait for a call. 

INIT, if the lOCP is to send a call request to initiate the call. 

USERINIT, if the station linked to the circuit provides the call request control 
message to initiate the call. 

Call ID 

is the 2-digit ID of the X.25 network address to be called (INIT) or waited on a 
call from (WAIT) when the station is started. The call ID and its associated 
X.25 network address must be defined in the $.SYSX25 data set. You may 
specify to accept any call when the contact type is WAIT. You may also 
specify if the address has to be obtained from the other faciUties. 

Protocol ID 

is an optional 8-digit hexadecimal protocol identifier. If specified, it is sent with 
the call request packet when the contact type is INIT, or used to screen incoming 
calls when the contact type is WAIT. Only incoming call packets with a 
matching protocol ID are accepted. The first two bits of the protocol ID have 
special significance to X.25 packet-switching networks. 



Facilities 

is one or more of the following facilities. 



ly 



58 Communications Facility Design and Installation Guide 



CUG nn Closed user group, nn is the 2-digit decimal ID of the group. 

BCUG nnnn Bilateral closed user group, nnnn is the 4-digit decimal ID of the 
group. 

RPOA nnnn This facility allows you to specify a particular RPOA transit 
network through which the call is to be routed internationally, 
when more than one RPOA transit network exists at an 
international gateway, nnnn is the 4-digit decimal data network 
identification code for the requested RPOA transit network. 

FS Fast select. Fast select allows from 1 to 128 bytes of user data to 

be carried on a call request, call accept, or call clear packet. 

FSR Fast select restricted. This allows from 1 to 128 bytes of user 

data to be carried on a call request or a call clear packet; call 
accept is not allowed. 

REV Reverse charging. The DTE accepting the call is charged for the 

call instead of the DTE that places the call. 

These are the facilities that the Communications Facility allows you to include in 
your station definition. The lOCP sends them on the call request control 
message for contact types INIT and USERINIT. Facilities are invalid for circuits 
with usage of CF or STD. 

You may choose only those facilities to which you have subscribed from your 
X.25 network. If you subscribe to facilities other than the ones allowed in the 
station definition, you can initiate the call (contact type USERINIT) and specify 
additional facilities in the call request control message. 

If you use CP DEF to define your circuit station, you don't define facilities when 
you define the circuit station. Instead, use the CP F FAC command after you 
have defined the circuit station. 

User Data 

is an optional 1- to 12-character user data field to be sent with the call request 
packet when the contact type is INIT. 

If you use CP DEF to define your circuit station, you don't define the user data 
field when you define the circuit station. Instead, use the CP F USER coimnand 
after you have defined the circuit station. 



Defining SNA PU Stations 






NA 

is the 4-digit hexadecimal network address. The leftmost two digits are the node 
assignment. The rightmost two digits may be any value from 01 to FF that is 
unique within the node. 

Type 
isPU. 
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Buffer Size 

is the size of the buffer required for the LU stations associated with this PU 
station, as explained in the chapter "Planning Storage Requirements" on 
page 213. If you use $. CONFIG to define stations, specify a decimal value. If 
you use CP DEF, specify a hexadecimal value. 

PU Number 

is the number of the PU defined to the EDX Secondary SNA2 for this PU 
station. If $NETx is the PU definition associated with this PU station, x is the 
PU number. 

Host AppUcation and Host Mode 

are the name and mode of an SNA application that users can select or to which 
they can be automatically connected. (Users may also specify SNA appUcations 
that are not defined in the PU station.) The name and mode are each one to 
eight characters, and must be defined in the SNA host system. You can define 
from zero to three SNA applications in the PU station. 

If you use CP DEF to define stations, you don't specify SNA applications when 
you define the PU station. Instead, use the CP F APPLn and CP F MODE« 
commands after you have defined the station. 

Note that: 

• You can't assign a disk queue to a PU station. 

• If you use CP DEF to define stations, you must also specify the subtype of the 
PU station. It is always 3274ES. 






Defining SNA LU Stations 



NA 

is the 4-digit hexadecimal network address. The leftmost two digits are the node 
assignment. The rightmost two digits may be any value from 01 to FF that is 
unique within the node. 

Type 
isLU. 

Term Type 

is the type of emulated terminal the LU represents. Specify 3277, 3278, 3279, 
3286, 3287, or 3289. 

PU Name 

is the name of the associated PU station. You must define the PU station before 
you can define LU stations. 

Local Address 

is either a logical unit number from 1 to 32 defined in the EDX-SNA 
configuration or 0. If you specify 0, EDX-SNA will assign the next available 
logical unit number when the station is started. 
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Logon ID 

is the identification of an SNA application. If you want the user of this station 
to be automatically connected to one of the SNA applications defined in the PU 
station, specify its number — 1, 2, or 3. If you want the user to be prompted for 
an SNA application, specify 0. If you want the host to initiate sessions with this 
station, specify HOST. 

User Data 

is an optional 1- to 16-character user data field to be passed to the SNA 
appUcation when communication with it is established. Omit this field if you 
supply a logon ID of or HOST. 



Defining Node Stations 






NA 

is the 4-digit hexadecimal network address. The leftmost two digits are the node 
assignment. The rightmost two digits must be 00. 

For a PC or CM node, the first two digits must be the hexadecimal 
representation of the alphabetic characters that the PC Connect or the 
Communications Manager uses to address this PC or CM node. For example, if 
this node is known to the PC Connect or Communications Manager as BB, the 
node address must be C200. 

Type 

is NODE. 

Node Type 

is CF for a Communications FaciUty system; CM for a Communications 
Manager system; and PC for a Personal Computer system. 

Ring Address 

is required only for Communications Facility or Communications Manager 
nodes. The ring address is the 2-digit hexadecimal Local Communications 
Controller ring address of the remote node. The address must have odd parity 
and a value, without the parity bit, from 16 to 125. Specify this parameter only 
if the remote node is connected to the same Local Communications Controller 
ring as the local node. 

Line Name 

is the name of the associated Local Communications Controller or Series/ 1 -PC 
Connect Attachment line station. Specify this parameter only if the remote node 
is connected to the same Local Communications Controller ring or Series/ 1 -PC 
Connect Attachment as the local node. You must define the line station before 
you can define the node stations. 

Volume name 

is required only for a PC node. It is the name of the associated volume station 
used for disk-server request. Specify the parameter only if the remote node is 
connected to the same Series/ 1 -PC Connect Attachment as the local node. You 
must define the volume station before you can define the associated node 
station. 
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Defining Device Stations 



NA 

is the 4-digit hexadecimal network address. The leftmost two digits are the node 
assignment. The rightmost two digits must be the device address pinned on the 
attachment card that controls the device. It can't be 00; for a device with 
hardware address 00, specify FF. 

Type 

is DEVICE. 

Device Type 

is one of the following: 

4978, to define a 4978 or 4980 terminal. 

PRINTER, to define a 4973, 4974, 4975, 5219, 5224, 5225, or 5262 printer. 

3101F, to define a 3101 terminal, a3161or3163 terminal, a 7485 terminal, or a 
Personal Computer emulating a 3101 attached to a Series/ 1 through an 
asynchronous adapter. 

Buffer Size 

is the size of the buffer required for the station, as explained in the chapter 

"Planning Storage Requirements" on page 213. If you use $. CONFIG to define 

stations, specify a decimal value. If you use CP DEF, specify a hexadecimal 

value. ^"^ 



PDS 

is required only for a printer device station. Specify Y or N to indicate whether 
or not you want a member in partitioned data set $.SYSPRT allocated for the 
station. The member is used to support the printer as a buffered device, as 
explained in the description of $.100674 in the chapter "Using the SuppUed 
Input/Output Control Programs" on page 71. 

Polling CUDA 

is a 3270 polling address that the Communications FaciUty doesn't use. You 
may specify any 4-digit hexadecimal value except 0000. If you link this station 
to an emulated terminal station for 3270 pass-through operations, you might 
specify the same polling address for both of them, although this is not required. 

Selection CUDA 

is a 3270 selection address, specified only for printer and 4978 device stations, 
that the Communications FaciUty doesn't use. You may specify any 4-digit 
hexadecimal value. If you link this station to an emulated terminal station for 
3270 pass-through operations, you might specify the same selection address for 
both of them, although this is not required. 

HDCPY 

is required only fora3101 or3101F device station. Specify the name of the 
EDX terminal to be used as the hardcopy device — the device on which the 
screen display is printed when an operator presses the PA6 key. 



w ^ 



o 
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Bit Rate 

is required only for a 3101F device station. Specify the bit rate of the feature 
programmable communications adapter (300, 600, 1200, 2400, 4800, or 9600) 
or the multifunction attachment (1200, 2400, 4800, or 9600). You must specify 
9600 for 7485s. 

Auto Ans 

is required only for a 3101F device station. If you use $. CONFIG to define 
stations, specify YES or NO to indicate whether or not the modem attached to 
the asynchronous adapter, supports auto answer. If you use CP DEF, specify 
ON or OFF instead. You must specify NO or OFF for 7485s. 



Defining Volume Stations 

NA 

is the 4-digit hexadecimal network address. The leftmost two digits are the node 
assignment. The rightmost two digits may be any value from 01 to FF that is 
unique within the node. 

Type 
is VOL. 

The station name must be the same as the EDX volume name that it represents. 

Defining User Stations 

J NA 

is the 4-digit hexadecimal network address. The leftmost two digits are the node 
assignment. The rightmost two digits may be any value from 01 to FF that is 
unique within the node. 

Type 

is USER. 

The station name must be the same name as the program it represents. 



Defining Message Stations 



NA 

is the 4-digit hexadecimal network address. The leftmost two digits are the node 
assignment. The rightmost two digits may be any value from 01 to FF that is 
unique within the node. 

Type 
is MSG. 
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Defining Terminal Stations 

NA \..J 

is the 4-digit hexadecimal network address. The leftmost two digits are the node 
assignment. The rightmost two digits may be any value from 01 to FF that is 
unique within the node. 

Type 

is TERM. 

Term Type 

is one of the following: 

3271, to define a control unit associated with a 327 IC or 327 IE line station. 

3277, to define a display station associated with a 3271 C or 327 IE line station. 

3286, to define a printer associated with a 3271C or 3271E line station. 

PORT, to define an emulated display station or printer associated with a CA line 
station. 

Line Name 

is the name of the associated 327 IC, 327 IE, or CA line station. You must 
define the line station before you can define the terminal stations. 

Polling CUD A ^ ^ 

is required only for 3271, 3277, and 3286 terminal stations. Specify the 3270 (. J 

polling address, as described later in this chapter. 

Select CUDA 

is required only for 3271, 3277, and 3286 terminal stations. Specify the 3270 
selection address, as described later in this chapter, 

Port# 

is required only for PORT terminal stations. Specify the port number, a decimal 
value from to 3 1 . 



Defining Remote Stations 



You can assign a remote station any type you choose. Suppose, for example, you 
are defining a station to represent a 4978 in a remote node. You can define it as a 
device station, but it's simpler to define it as a message station. The latter 
definition provides all the information needed to build a remote station block. 

The only requirement is that the network address of the remote station must be the 
same as that of the corresponding real station in the remote node. The station 
names need not be the same. 
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Defining Alias Stations 



Linking Stations 






O 



NA 

is the 4-digit hexadecimal network address. The leftmost two digits are the node 
assignment. The rightmost two digits may be any value from 01 to FF that is 
unique within the node. 

Type 

is ALIAS. 

Alias 

is the 1- to 8-character name of the station for which this is an alias. 

Note that you can't assign a disk queue to an aUas station. 



Having defined your stations, you will need to define links for some of them. 
Recall that there are two kinds of links. A direct link defines the default 
destination of messages sent by a station. An alternate link defines a station to 
which the program dispatcher sends undeliverable transactions or to which the 
X.25 lOCP sends X.25 control messages. 

You can use the $. CONFIG LINK or CP LINK command to define both kinds of 
links. 

This section offers some general guidelines for defining direct Unks. You should 
also study the chapter "Sample Configurations" on page 269, which shows the 
Unks required for various configurations. 

Some stations must have a direct link, because otherwise the messages they send 
are undeliverable. 

A device station, an SNA LU station, and any terminal station except one that 
represents a 3271 control unit require a direct link. To do 3270 pass-through, Unk 
pairs of stations to each other. One station of each pair is a device or real 3270 
terminal station; the other is an emulated 3270 terminal or SNA LU station. 

If you write appUcation programs that communicate with terminal users, link the 
device or real 3270 terminal stations to the program (that is, to its user station). If 
you write application programs that communicate with host systems, Unk the 
emulated 3270 terminal or SNA LU stations to the program. Interactive 
appUcation programs are usually written to communicate with multiple users, 
obtaining the origin of each message they receive and sending the response back to 
that station. If your program communicates with only one station, you can also 
define a link from the program to that station. 

When you define an emulated terminal or SNA LU station, take care that the 
station's subtype is consistent with the type of station with which it wiU be Unked: 

• Link 3277 emulated terminal stations or 3277 LU stations with stations that 
represent 4978s, 4980s, 3101s, 7485s, real 3277 displays, or programs that 
process 3270 data streams. 
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• Link 3286 emulated terminal stations or 3286 LU stations with stations that 

represent 4973, 4974, 4975, 5219, 5224, 5225, or 5262. /^~\ 

\J 

• Link 3287 LU stations with stations that represent 3287 printers or Series/ 1 
printers managed by $.100674 which includes LU-1 support. 

• Link 3278 and 3279 LU stations with stations that represent the corresponding 
real 3270 displays. 

A circuit station with usage STD or STD+ requires a direct link. Link the station 
to the station that is to receive data from the circuit. If usage is STD+, you can 
also define an alternate Unk; the direct link will receive data messages from the 
circuit; the alternate link will receive X.25 control messages. 

A node station requires a direct Unk unless it represents a remote node that is 
connected to the same Local Communications Controller ring or Series/ 1 -PC 
Connect Attachment as the local node. If the remote node is accessed through a 
BSC point-to-point line, link the node station to the CPU line station (see sample 
configuration 5). If the remote node is accessed through an HDLC hne, link the 
node station to a circuit station with usage CF (see sample configuration 11). If 
the remote node is accessed through a Local Communications Controller ring or a 
Series/ 1 -PC Connect Attachment, but it is not physically connected to the local 
node, link the node station to the node station that represents the intermediate 
node (see example 11). 

A PTPT line station (one that represents a point-to-point connection between a 

Series/ 1 and some other system) requires a direct link. Link the station to the ^ .. 

program or device that is to receive data sent by the other system. ( J 

A volume station (one that represents emulated PC disks on a LAN) requires a 
direct link. Link the volume station to the PC node station that represents the 
gateway PC on the LAN which uses the emulated PC disks as LAN-shared disks. 

Some stations don't ever need a direct link, because they are never the origin of 
messages. These stations are: 

• Node station for remote nodes that are connected to the same Local 
Communications Controller ring or Series/ 1 -PC Connect Attachment as a 
local node 

Circuit stations with usage CF 

Terminal stations that represent 3271 control units 

Line stations except PTPT 

An SNA PU station 

Remote stations. 

You can define direct links for such stations, but the definition will have no effect. 
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Defining Modes of Operation 



Some of the lOCPs support alternative modes of operation for the stations they 
manage, as described in the chapter "Using the Supplied Input/Output Control 
Programs" on page 71. When you define stations, you estabUsh default modes of 
operation. Having defined a station, you can use the CP F MODE command to 
specify some other mode. 



3270 Polling and Selection Addresses 






The polling and selection addresses for a real or emulated 3270 terminal station 
depend on the terminal's control unit number and device number. Each control 
unit has a number from to 3 1 . Each device (display station or printer) is attached 
to a control unit and has a number from to 3 1 that represents its position on the 
control unit. For real 3270 terminals, these numbers are assigned when the 
terminals are installed. For emulated 3270 terminals, the numbers are defined by 
the host program with which the Series/ 1 communicates. If you use CP DEF to 
define stations, you must specify the polling and selection addresses. If you use 
$. CONFIG, you can instead specify the control unit number and device number, 
and $. CONFIG will generate the appropriate polling and selection addresses. 

Each address is a 4-digit hexadecimal value. The first two digits are referred to as 
CU (control unit) and the last two as DA (device address). Use Figure 19 on 
page 68 and the following rules to determine the polling and selection addresses 
for a terminal station: 

• The polling address for a control unit is the value from column 2 for the 
corresponding control unit number followed by 7F. 

• The selection address for a control unit is 0000. 

• The polling address for a device is the value from column 2 for the 
corresponding control unit number followed by the value from column 2 for 
the corresponding device number. 

• The selection address for a device is the value from column 3 for the 
corresponding control unit number, followed by the value from column 2 for 
the corresponding device number. 
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For example, the polling and selection addresses for control unit 5 and its devices 
0, 1, and 2 are: 



Station 


Polling Address 


Selection Address 


Control Unit 5 


C57F 


0000 


Device on CU5 


C540 


E540 


Device 1 on CU5 


C5C1 


E5C1 


Device 2 on CU5 


C5C2 


E5C2 



% 



Remote IPL Note: The strapping for remote IPL on a BSC adapter card is also the 
high-order bit of the polUng address. With IPL enabled, polling addresses must 
begin with 'C or *D' and selection addresses with 'E' or 'F'. 



Control Unit 

or 

Device Number 


Polling CU 
Polling DA 
Selection DA 


Selection CU 





40 


60 


1 


CI 


61 (El)i 


2 


C2 


E2 


3 


C3 


E3 


4 


C4 


E4 


5 


C5 


E5 


6 


C6 


E6 


7 


C7 


E7 


8 


C8 


E8 


9 


C9 


E9 


10 


4A 


6A 


11 


4B 


6B 


12 


4C 


6C 


13 


4D 


6D 


14 


4E 


6E 


15 


4F 


6F 






Figure 19 (Part 1 of 2). 3270 Polling and Selection Addresses 



1 For 3270 emulation, the Series/ 1 communication hardware doesn't honor selection 

CU values 61 and FO. Use the values El and 70 instead in your station definitions and 
in host system definitions. 
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Control Unit 

or 

Device Number 


Polling CU 
Polling DA 
Selection DA 


Selection CU 


16 


50 


FO (70)1 


17 


Dl 


Fl 


18 


D2 


F2 


19 


D3 


F3 


20 


D4 


F4 


21 


D5 


F5 


22 


D6 


F6 


23 


D7 


F7 


24 


D8 


F8 


25 


D9 


F9 


26 


5A 


7A 


27 


5B 


7B 


28 


5C 


7C 


29 


5D 


7D 


30 


5E 


7E 


31 


5F 


7F 



Figure 19 (Part 2 of 2). 3270 PoUing and Selection Addresses 
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Using the Supplied Input/ Output Control Programs 



This chapter explains the requirements and restrictions you need to take into 
account if you're going to use the lOCPs that are supplied as part of the 
Communications Facility. For each lOCP, it explains hardware requirements; 
EDX requirements; station definition requirements; and detailed information about 
the particular lOCP. 

The lOCPs that are described in this chapter are: 

PC Connect lOCP, $.100 AA8 

Series/ 1-to-Series/l Local Communications Controller lOCP, $.100 ABO 

X.25 lOCP, $.IO0AB8 

3270 control lOCP, $.IO0AC0 

Series/ l-to-System/370 channel attachment lOCP, $.IO0AD0 

Series/ 1-to-host 3270 emulation lOCP, $.IO0AE0 

Series/ 1-to-Series/l ESC lOCP, $.IO0A10 

Point-to-point BSC lOCP, $.IO0A20 

3101 terminal lOCP, $.IO06F0 

4978/4980 data stream lOCP, $.100670 

Printer lOCP, $.100674 

7485 terminal lOCP, $.100680 

PC Connect disk-server lOCP, $.I01CC8 

Series/ 1-to-host SNA lOCP, $.I014E8. 



Buffer Requirements 



Each lOCP has a buffer pool from which it obtains buffers to process messages for 
the stations it manages. The sizes of the buffer pools, as distributed, may not be 
suitable for your installation. The chapter "Planning Storage Requirements" on 
page 213 explains how to determine the buffer size required for stations and the 
buffer pool size required for each lOCP. 



Modes of Operation 



Some of the lOCPs supplied with the Communications Facility allow you to select 
between different modes of operation. 

Figure 20 on page 72 summarizes these modes of operation. It shows the types of 
stations to which modes of operation apply, the lOCPs that support the modes, the 
default modes, and the alternatives. 
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Default modes of operation are established when you define stations. You can use 
the CP F MODE command to specify alternative modes for stations. 

The following sections describe the various modes of operation. For more 
information about how a particular lOCP supports a mode of operation, see the 
description of that lOCP. 






station Type 


lOCP 


Default Mode 


Alternative Modes 


CP F MODE 

Parameters 


Terminal 


$.IO0AC0 


Basic 


Record 


BAS, REC 






Non-display 


Text 


NON-D, TEX 


Terminal 


$.IO0AE0 


Basic 


Record 


BAS, REC 


Terminal 


$.IO0AD0 


Basic 


Record 


BAS, REC 


SNALU 


$.I014E8 


Basic 


Record 


BAS, REC 






Unbind stop 


Unbind retry 


UBSTOP, UBRETRY 






NETINIT wait 


No NETINIT wait 


WAIT, NOWAIT 






No Personal Computer 


Personal Computer 


NOPC, PC 


Circuit (INIT) 


$.IO0AB8 


Stop 


Retry 


STOP, RETRY 


4978 device 


$.100670 


Upper/lower 


Lower/upper 
Upper/upper 


UL, LU, UU 


Printer device 


$.100674 


Basic 


— 


— 






Non-display 


Text 


NON-D, TEX 






3270 data stream 


SNA character string 


3270, SCS 






Upper case 


Mixed case 


UC,MC 


3101 


$.IO06F0 


Basic 


— 


— 


or 7485 device 


$.100680 


Non-display 


Text 


NON-D, TEX 
BIT rate 






Auto-answer off 


Auto-answer on 


AUT ON, AUT OFF 


PTPT line 


$.IO0A20 


Basic 


Record 


BAS, REC 






Secondary 


Primary 


SEC, PRI 






Nontransparent write 


Transparent write 


XOFF, XON 


User 


$.100670 

$.100674 

$.100680 

$.IO06F0 

$.IO0AC0 

$.IO0AD0 

$.IO0AE0 


Non-remove 


Remove 


NON-R, REM 


User 


$.I014E8 


Remove 


Non-remove^ 


REM, NON-R 






Figure 20. lOCP Modes of Operation 



2 Terminal operator can use keyboard to select mode. 

3 Must be specified after IOC? is started. 
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Basic and Record Modes 



The terms basic mode and record mode are used to describe data as well as modes 
of operation. Basic mode data is data that contains device-dependent information, 
such as BSC and 3270 control characters. Record mode data does not contain 
device-dependent information. 

When an lOCP receives record mode data to be transmitted out of the Series/ 1 (to 
a terminal, a device, or a communication line), it appends the required 
device-dependent information. It does so whether or not the station is in record 
mode. 

Data transmitted into the Series/ 1 is always basic mode data. When a terminal 
station (real or emulated) or an SNA LU station is in record mode, the lOCP 
removes the device-dependent information before sending the data on to the 
station's direct link. When a PTPT line station is in record mode, the lOCP 
removes the first character (STX) and the last character (ETB or ETX) from the 
data before sending it to its destination. When a PTPT line station is in record 
mode and the data is transparent, the lOCP sends the data without modification to 
its destination. The lOCP also issues a warning log message to report that it 
received transparent data for a station in record mode. When a station is in basic 
mode, the lOCP sends the data without modification. Note that record mode is not 
supported for device stations. 

Two 3270 terminals can communicate directly with each other (not through an 
application program) only if they are in record mode. They can't communicate 
directly if they're in basic mode because the device-dependent information in input 
data is not the same as that required for output. A 3270 terminal in record mode 
can also send messages to a device station, but the reverse is not true. 

Basic and record modes of operation don't apply to the Series/ 1-to-Series/l 
lOCPs, ($.IO0A10, $.IO0AB0, and $.IO0AB8), and they don't apply to the PC 
Connect lOCP, $.100 AA8. These lOCPs don't modify the content of messages 
they transmit between Series/ Is or between Series/ 1 and Personal Computers. 
$.IO0A10 , $.IO0AA8, and $.IO0AB0 do append the required line protocol 
characters to output messages and remove them from input messages. 



Non-Display and Text Modes 



Non-display and text modes apply to 3270 terminals, 3101 and 7485 devices, and 
printers. For these stations, non-display means uppercase only, and text means 
uppercase and lowercase. When such a station is in non-display mode, the lOCP 
translates lowercase characters to uppercase in input from a 3270 terminal or a 
7485 device, and in output to a printer or a 3101 or 7485 hardcopy device. When 
the station is in text mode, the lOCP doesn't translate data. 



UBSTOP and UBRETRY Modes 






An SNA logical unit (LU) station is in either UBSTOP or UBRETRY mode. These 
modes affect what happens when the host sends an unbind request to terminate a 
session that was established automatically. If the station is in UBSTOP mode, the 
lOCP stops the station. If the station is in UBRETRY mode, the lOCP tries to 
rebind the session until it is successfully reconnected. You must stop the LU station 
to end the session. 
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STOP and RETRY Modes 



An SVC circuit station that was defined with a contact type of INIT is either in 
STOP or RETRY mode. These modes affect what happens when the virtual call 
that the station initiated is cleared. If the station is in STOP mode, the lOCP stops 
the station. If the station is in RETRY mode, the lOCP tries to reinitiate the call. 
If it is in RETRY mode, you must stop the circuit station to end the session. 



WAIT and NO WAIT Modes 



An SNA logical unit (LU) station is either in WAIT mode or NOW AIT mode. 
These modes affect what happens when the lOCP issues a NETINIT and the 
LU-to-SSCP session is not available. If you specify WAIT mode, EDX-SNA 
support waits until the session is established. If you choose NOW AIT mode, 
EDX-SNA support completes the NETINIT with a negative return code. 



Personal Computer or No Personal Computer Modes 



An SNA logical unit (LU) station is either in PC or NOPC mode. When the 
station is in PC mode, the SNA lOCP assumes that messages sent to and from the 
LU station are through a Series/ 1 -PC Connect Attachment. When the station is in 
NOPC mode, the lOCP assumes that the LU station is not connected through a 
Series/ 1 -PC Connect Attachment. Specify PC mode when the LU station sends or 
receives messages through a Series/ 1 -PC Connect Attachment. 

Note: You must specify PC or NOPC mode for the SNA lOCP to function .^A 



correctly. 



Upper/Lower, Lower/Upper, and Upper/Upper Modes 



'\J 



For a 4978 device, these modes of operation define the relationship between the 
keyboard shift and the lowercase and uppercase alphabets. Only the 26 letters of 
the alphabet are affected by these modes. 

When a station is in upper /lower mode, downshift (shift key not depressed) 
produces uppercase letters, and upshift (shift key depressed) produces lowercase 
letters. When a station is in lower /upper mode, downshift produces lowercase 
letters, and upshift produces uppercase letters. When a station is in upper /upper 
mode, either downshift or upshift produces uppercase letters. 



Alphanumeric and Numeric Modes 



When a station is in numeric mode, the lOCP validates data entered into fields that 
have the numeric attribute. The only valid characters are digits, periods, and minus 
signs. When a station is in alphanumeric mode, the operator can enter any data in 
any field, whatever its attribute. 
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3270 and SCS Modes 



The alphanumeric/numeric support is provided as follows: 

• For a 3270 terminal, numeric mode is supported by optional hardware, the 
Numeric Lock special feature. The operator may or may not be able to disable 
numeric field validation, depending on the type of keyboard. 

• For a 3101 or a 7485 device, the lOCPs support numeric mode; it is always in 
effect. 

• For a 4978 or 4980 device, the control store supports numeric mode. The 
operator can disable numeric field validation. 



A printer station is in either 3270 data stream or SNA character string (SCS) 
mode. If the printer station is in 3270 mode, data received by the lOCP for 
transmission to the printer is interpreted as 3270 data stream. If the printer station 
is in SCS mode, data received by the lOCP for transmission to the printer is 
interpreted as an SCS data stream. 



Upper Case and Mixed Case Modes 



These modes determine whether printer devices print in all uppercase or mixed 
case. 






Primary and Secondary Modes 



A FTPT Une station managed by the point-to-point BSC lOCP is in either primary 
or secondary mode. If both a primary and a secondary station try to seize control of 
the line at the same time, the primary station goes first. The secondary station can 
transmit messages only when the primary station has left the line idle. 

A PTPT line station normally operates as the secondary station, because the 
2770-like devices with which it exchanges data normally operate as primary 
stations. If you use the point-to-point BSC lOCP for communication between 
Series/ Is, set one of the PTPT line stations to primary mode and the other to 
secondary mode. 

XON and XOFF Modes 

A PTPT line station managed by the point-to-point BSC lOCP is in either XON or 
XOFF mode. If it is in XON mode, the lOCP writes its data using transparent 
write. If it is in XOFF mode, the lOCP writes its data using nontransparent write. 

Bit Mode 

This mode determines the bit rate for 3101s and 7485s defined as 3101F stations. 
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Auto- Answer On and Auto- Answer Off Modes 



These modes determine whether the lOCP controlling a 3101, defined as a 3101F 
station, needs to support auto-answer. 



Remove and Non-Remove Modes 



Remove and non-remove modes apply to the user stations for lOCPs that manage 
devices, terminals (real or emulated), and SNA LUs. A real 3270 system operates 
in certain ways because its devices are buffered. When an lOCP is in remove mode, 
it simulates these buffered operations; when it's in non-remove mode, it doesn't. 

When a 3270 terminal operator presses a program attention key (for example, 
ENTER), data is transferred to the device buffer, where it remains until the host 
program soUcits input. If response time is slow, an impatient operator may press 
RESET and then ENTER again. This affects only the device buffer. When the 
host program solicits input, it receives the last message the operator entered. 

In a 3270 pass-through operation, where a device or 3270 terminal station is linked 
with an SNA LU or emulated terminal station, pressing RESET and then ENTER 
has a different effect. Each time the operator presses RESET and then ENTER, 
another message is sent to the emulated terminal station. When the host program 
solicits input, it may receive duplicate messages. 

When an lOCP that manages devices or 3270 terminals receives an input message, 
it sends the message on to the station's direct link. If the lOCP is in remove mode 
and if the direct link station is an SNA LU or emulated terminal station, the lOCP 
purges the direct link station's message queue before sending it the latest message. 
If the lOCP is in non-remove mode or the direct link station is of some other type, 
the lOCP just sends the message. 

Device buffers also affect the results of a host program sending output to a 3270 
terminal. The output data is transferred to the device buffer, and may overwrite 
pending input data. 

When an lOCP that manages SNA LUs or emulated terminals receives data from 
the host, it sends the data on to the station's direct link. If the lOCP is in remove 
mode, it first purges pending input data; that is, it purges the message queue of the 
SNA LU or emulated terminal station. If the lOCP is in non-remove mode, it 
doesn't purge pending input. 



X.J 



/^'A 
w M 
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$.IO0AA8 



PC Connect lOCP, $.IO0AA8 



Af^"\. 



The PC Connect lOCP manages communication between a Series/ 1 and a 
Personal Computer (PC) connected by a Series/ 1 -PC Connect Attachment. The 
lOCP allows all the Personal Computers in an IBM PC local area network (LAN) 
to communicate with the Series/ 1 through a PC, called the gateway PC. The 
gateway PC is directly linked to the Series/ 1 and performs all the message handling 
and program-to-program communications between the PCs on the LAN (user PCs) 
and the Series/ 1. The lOCP can manage multiple attachments to various LANs. 

You can use the lOCP in these ways: 

• To allow a PC user to pass through to one or more hosts as a 3278. See 
example 15 in the chapter "Sample Configurations" on page 269. 

• To allow a PC user to transfer files to and from any host over SDLC 

• To use a Series/ 1 data set as a LAN-shared PC disk 

• To allow a PC user to use a Series/ 1 printer as a LAN-shared printer 

• To extend the current message function of the IBM PC network and to allow 
your computer to communicate with other computers on another LAN 
(inter-LAN messaging). See example 16 in the chapter "Sample 
Configurations" on page 269. 

• To allow communication between PC programs on separate IBM PC networks 

• To allow communication between Series/ 1 programs and PC programs 

• To allow a PC program to issue user error log messages to an EDX error log 
file on the Series/ 1. 



Hardware Requirements 



EDX Requirements 



Use of this lOCP requires the Series/ 1 -PC Connect Attachment (feature number 
4000) and the cable (feature number 4001). 



Include Communications Facility PC Connect support modules in the EDX 
supervisor. The required modules are: 

• CSPCCINT, the PC Connect initialization routine 

• CSPCCIPL, the PC Connect initialization call routine 

• CSPCCOPN, the PC Connect microcode data set(s) open routine 

• CSPCCPTC, the PC Connect microcode patch load routine. 

Include EDX Local Communications Controller support (LCCAM) in the EDX 
supervisor. EDX unmapped storage support must be included. 
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Personal Computer Requirements 



Station Definitions 



Use of this lOCP requires Series/ 1 -PC Connect (5719-CNl). For information on ,^ 

hardware and software requirements for the PC and Series/ 1 -PC Connect, see the \-. 

IBM Series /I -PC Connect for the Event Driven Executive Communications Facility. 



Define stations to represent: 

. ThelOCP. Name=$.IO0AA8, type=USER. 

• Each Series/ 1 -PC Connect Attachment. Type=LINE, subtype=PCC. 

• Each gateway PC as a remote node station. Type=NODE, subtype=PC. 

• Each PC on the LAN as a remote station. This definition is required only if 
host communication is requested. 

• Each Series/ 1 printer used by the LAN as a printer running in SCS mode. 
Type=DEVICE, subtype = printer. 

• Each volume to be used by the LAN to hold emulated PC disks. 
Type=VOLUME. 



A link between the printer station and the node station is required. A link between 
the remote station representing the PC and the host emulated terminal is required 
to pass through and transfer files to and from the host. A link between the volume 
station and the node station is required. 

The gateway PC appears to the Series/ 1 as a PC node connected through a 
Series/ 1 -PC Connect Attachment. The gateway PC uses a 2-character alphabetic 
name to identify nodes instead of a hexadecimal node assignment. Specify a 
repeated letter (for example, AA) as the LAN name on the gateway PC. Specify a 
hexadecimal representation of the letter as the node assignment for the PC node 
(for example, X'Cl')- 



lOCP Operation Overview 



The PC Connect lOCP consists of a main task and three subtasks for each started 
line station — a device task, a read task, and a request task. The main task 
processes commands to stop or halt the lOCP and commands to start, stop, halt or 
vary off-line stations. The device task controls the other two subtasks and 
transmits all outgoing messages and control messages on subchannel 2 of the 
device. The read task receives all incoming data messages on subchannel 1 and 
routes them through the message dispatcher to the appropriate station. The request 
task receives all incoming control messages on subchannel 0. 

Once the line station is started, you can start the node station and remote stations 
representing the PCs on the network. Message transmission cannot occur untU the 
lOCP has established communication between the Series/ 1 and the gateway PC. 
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Establishing Communication 



To establish communication between the Series/ 1 and the gateway PC, start the 
PCC Une station and the node station that represents the gateway PC. When the 
PC Connect in the gateway PC is operational, the two systems exchange a 
sequence of control messages (on-hne broadcast and on-line response) to establish 
communication. 



Sending Messages 



Once communication has been established, message transmission between the 
Series/ 1 and PCs can begin. 



When a message is placed on a PC node station's queue, the lOCP retrieves it and 
transmits it over the Series/ 1 -PC Connect Attachment. A 20-byte Personal 
Computer message header precedes each outgoing message. If the flag bit in the 
Communications Facility message header indicates that the message includes a 
Personal Computer message header, the Communications Facility header is 
removed and the message is transmitted. Otherwise, the lOCP converts a 
Communications Facility message header to a Personal Computer message header 
before transmitting the message. For more information on the Personal Computer 
message header, see the Series /I -PC Connect for the Event Driven Executive 
Communications Facility. 



Receiving Messages 



When the lOCP receives a message from the PC Connect, it identifies the function 
request by a byte in the Personal Computer message header. The function 
identifiers are: 

Print-server request 

Host communication request 

Inter-LAN message request 

Program-to-program communication request 

Disk-server request 

Error log request 

User defined function request. 

If the lOCP has a direct link vector, it sends the message to the direct link vector 
station, with the Communications Facility message header in the first 20 bytes of 
the message data area. For inter-LAN messaging or PC program-to-PC program 
communication, there will be a Communications Facility and a Personal Computer 
message header in the first 40 bytes of the message data area. 

Print-server Request: The lOCP converts the Personal Computer header to a 
Communications Facility header and sends the message to the printer. The printer 
is represented by a printer station running in SNA character string (SCS) mode 
with the same name as the PC printer that is being emulated (such as LPTl, LPT2, 
LPT3, COMl, COM2, PRN, and AUX). The printer stations should be linked to 
the node station for the LAN which they are serving. 



^^n^ 
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Control Messages 



Host Communication Request: The lOCP converts the Personal Computer header to 

a Communications Facility header using the origin station's direct link as the 

destination station. /^\ 



The IOC? handles segmented messages also. When the lOCP receives the first 
message in a chain of segmented messages, it obtains a 2K mapped or unmapped 
storage block. It stores all the messages from the same origin station in the 2K 
block until the last message in a chain of messages is received. After storing the 
last message in the chain or the only message in a chain, the lOCP sends the 
message to the origin station's direct link vector. 

Inter-LAN Message Request: In this case the lOCP does not convert the Personal 
Computer header to a Communications Facility header. It prefixes a 
Communications Facility message header to the Personal Computer message 
header. The Communications Facility header specifies the destination station of 
the remote node station representing other PCs on another LAN. The 
Communications Facility header has a flag bit turned on to indicate a PC-to-PC 
message. 

Program-to-program Communication Request: The lOCP tries to locate, by name, 
the destination station in the local Series/ 1. If the lOCP finds a station with the 
same name as the destination station specified, the lOCP assumes that the 
destination is a Series/ 1 program. It converts the Personal Computer header to a 
Communications Facility header and sends the message to the dispatcher for 
routing. On the other hand, if the lOCP does not find a station with the same 
name as specified by the destination station name, the lOCP assumes that the 
destination is a PC program. In that case it processes the message by prefixing the 
Communications Facility header as it does for inter-LAN messaging. 

Disk-server Request: The lOCP converts the Personal Computer header to a 
Communications Facility header and sends the message to the volume station 
defined at station definition time. The volume station should be linked to the node 
station for the LAN which it is serving. It is important to note that for each node 
station representing a gateway PC, there is only one volume station associated with 
it. 

Error Log Request: If the destination station is LOGO, the lOCP writes the data to 
the log data set in EDX as a user error with the permanent error indicator on. 

User Defined Function Request: The lOCP processes this request in the same way as 
it handles a request for program-to-program communication. See 
"Program-to-program Communication Request" for more information. 



This section describes the control messages that the lOCP sends or receives. These 
messages are all received on subchannel of the PC Connect. 
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On-line Broadcast 



On-line Response 



Off-line Notification 
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The lOCP uses the PC Connect broadcast command to send an on-line broadcast 
message to the gateway PC when it receives a command to start a node station. 



The lOCP sends an on-line response when it receives an on-line broadcast 
message, or when it receives an on-line response message and the Series/ 1 and the 
PC are not in communication. When the lOCP receives the on-line response and 
recognizes the PC node station that sent the message, communication is 
established. 

The buffer size of the line station is included in this message. If the Series/ 1 and 
the PC have different line buffer sizes, the smaller size determines the amount of 
data they can send to each other. 



This message is used to stop communications. The lOCP sends an off-line 
notification message to each gateway PC with which it has established 
communication, when the line station on the Series/ 1 is stopped or halted. 



Restrictions 



^\ 



The Communications Facility does not have an end-to-end protocol between 
Series/ 1 and PC nodes, therefore there is no message integrity. If you requke 
message integrity, you must implement it within the application programs in the 
Series/ 1 or the PC. 

Do not cancel $.IO0AA8 using the EDX $C command. If you do, the mapped and 
the unmapped storage obtained by the lOCP is not returned to the system. Use CP 
H $.100 AA8 to terminate the lOCP user station and its device stations. 



Using the Supplied Input/Output Control Programs 8 1 






Q 



82 Communications Facility Design and Installation Guide 



^EEEm 






Series/l-to-Series/1 Local Communications Conti'oUer lOCP, 
$.IO0AB0 

The Series/ 1-to-Series/l Local Communications Controller lOCP manages 
communication between Series/ Is attached to a Local Communications Controller 
ring. The lOCP can manage multiple attachments to different rings. 

You can use the lOCP in these ways: 

• To send messages from stations in one Series/ 1 to stations in another Series/ 1 
where $.100 ABO is running. See example 5 in the chapter "Sample 
Configurations" on page 269. The example explains how a message is routed 
from its origin in one node to its destination in another node. 

• To send messages from stations in one Series/ 1 to stations in another Series/ 1 
where the Communications Manager Local Communications Controller 
message path program is running. In such a configuration, you can also receive 
messages and commands from the Communications Manager system. 

• To send messages from stations in one Series/ 1 to stations in another Series/ 1 
that is not attached to the ring, but that is connected to a Series/ 1 on the ring. 
See example 11 in the chapter "Sample Configurations" on page 269. 

• To IPL a remote Series/ 1 that is attached to the ring and strapped for remote 
IPL. 

• To enable a remote Series/ 1 that is attached to the ring to access disks 
attached to the local Series/ 1 . The remote Series/ 1 must have remote disk 
support in the EDX supervisor, but the Communications Facility need not be 
running. 



Hardware Requirements 



EDX Requirements 



^■ImjV' 



Use of this lOCP requires the Local Communications Controller (feature number 
1400). 

To allow a node to be IPLed by another node on the ring, install the ring remote 
IPL jumper. If the IPL is to be initiated manually (through the LOAD button on 
the console), also install the primary IPL source or alternate IPL source jumper. 



Include the EDX Local Communications Controller support modules in the EDX 
supervisor. See the EDX Installation and System Generation Guide for all the 
information needed. 
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Station Definitions 



Define stations to represent: i'^'^™\ 

. ThelOCP. Name=$.IO0AB0, type=USER. 

• Each Local Communications Controller attachment. Type=LINE, 
subtype=LCC. 

• Each remote node to which local stations will send messages. Type=NODE, 
subtype=CF (Communications Facility system) or CM (Communications 
Manager system). 

• Each remote station to which local stations will send messages. 

No links are required for the line or node stations. Link the other remote stations 
as required for the communication you want. Be sure that each node has a unique 
node assignment and that the network address of each remote station is the same 
as the network address of the corresponding real station in the remote node. 



lOCP Operation Overview 



The Local Communications Controller lOCP consists of a main task and four 
subtasks for each started hne station — a device task, a read task, a request task, 
and an attention task. The main task processes commands to stop or halt the lOCP 
and commands to start, stop, halt, or vary off line stations. The device task 
controls the other three subtasks and transmits all outgoing data messages and 
control messages on subchannel 2 of the device. The read task receives all 
incoming data messages on subchannel 1 and routes them through the message 
dispatcher to the appropriate station. The request task receives all incoming 
control messages on subchannel 0. The attention task handles all attention 
interrupts that the Local Communications Controller device generates. 

Once the line station is started, you can start node stations representing other 
Series/ Is on the Local Communications Controller ring. You can then IPL a 
remote node. Message transmission between stations can't occur until the lOCP 
has established communication with the remote node. 






Establishing Coininimication 



To establish communication between two nodes, start the line station and the node 
station that represents the remote Series/ 1 in each node. The two nodes exchange 
a sequence of control messages (on-line broadcast and on-line response) to 
establish communication. The lOCP tries to establish communications whenever a 
node station is started or whenever a stopped line station is restarted. 

Once communication has been established, message transmission between stations 
on the two nodes can begin. 



o 
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Sending Messages 
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When a message is placed on a node station's queue, the lOCP retrieves it and 
transmits it over the Local Communications Controller. A 20-byte message header 
precedes each outgoing message. If the node station's subtype is CF, the header is 
the Communications Facility message header, minus the first 4 bytes (words 
M$NIQ and M$PIQ). If the node station's subtype is CM, the lOCP converts the 
Communications FaciUty message header to a Communications Manager message 
header. See the Debugging Guide for a description of the Communications Facihty 
message header, and the Communications Manager Assembler- Language 
Programmer's Guide for a description of the Communications Manager message 
header. 



Receiving Messages 



The lOCP blocks outgoing messages when it can. It transmits one or several 
messages when the buffer is full or when there are no more messages on the node 
station's queue. 



When the lOCP receives a message from the Local Communications Controller, it 
uses the ring address to identify the sending node. If the subtype of the node 
station is CF and the lOCP has no direct Unk vector, the lOCP sends the message, 
with its header, to the message dispatcher. The message dispatcher dispatches the 
message according to the destination information in the message header. If the 
lOCP has a direct hnk vector, it sends the message to that station, with the message 
header in the first 20 bytes of the message data area. 



If the subtype of the sending node station is CM, the lOCP converts the 
Communications Manager message header to a Communications Facility message 
header. If the message is a data message, the lOCP then handles it as if it were a 
message from a Communications Facility node. If the message is a command, the 
lOCP sends it to the command processor, which calls on module $.CPCMCF to 
process it. See the Communications Manager Operator's Guide for a description of 
the commands that a Communications Manager node can send to a 
Communications Facility node. 



Control Messages 



On-Line Broadcast 



On-Line Response 



This section describes the control messages that the lOCP sends and/or receives. 
These messages are all received on subchannel of the Local Communications 
Controller. 



The lOCP uses the Local Communications Controller broadcast command to send 
an on-line broadcast message when it receives a command to start a node station or 
a command to start or restart a line station. 



The lOCP sends an on-Une response message when it receives an on-line broadcast 
message, or when it receives an on-line response message and the two nodes are 
not in communication. When the lOCP receives the on-line response and 
recognizes the node station that represents the Series/ 1 that sent the message, 
communication is established. 
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Off -Line Notification 



Traffic Control 



IPL Request 



IPL Response 



Remote Disk On-Line 



Null Message 



Positive Response 



Negative Response 



The buffer size of the line station is included in this message. If the two nodes 
have different line buffer sizes, the smaller size governs the amount of data they 
can send to each other. 



This message is used to stop communications. The lOCP sends an off-line 
notification message to each node with which it has established communication 
when the line station is stopped or halted. 



The lOCP receives this message when a Communications Manager operator issues 
a traffic control command. The lOCP issues a CP command to stop or start the 
specified node station. 



The lOCP receives this message when the Communications Manager issues a 
conditional IPL command. The lOCP issues a WRITE IPL REQUEST command 
enabling the Communications Manager to perform the remote IPL. 



An IPL bootstrap sends this message; the lOCP uses it to control the remote IPL 
process. 



Remote disk support sends this message during EDX initialization. It notifies the 
lOCP that remote disk support is available. 



The lOCP sends a null message when it detects that the attachment has lost an 
acknowledgment. The message resets hardware sequence counts. 



The lOCP sends a positive response whenever it successfully receives a message 
block greater than IK bytes on subchannel 1. 



The lOCP sends a negative response whenever it receives an incomplete message 
block on subchannel 1 . 



Restrictions 



Between two Series/ Is, you can have only one active Local Communications 
Controller connection, BSC point-to-point connection, or X.25 connection through 
circuit stations with a usage type of CF. You can define and start more than one 
such connection, but only the one you start first is used. 
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When you're communicating with a Communications Manager node, there are 
restrictions on node assignment and station names, as described in the chapter 
"Defining Stations" on page 45. 

The Communications Manager supports segmented messages, but the 
Communications Facility doesn't. The Communications Manager accumulates 
segments of a message and sends the entire message as one data block to the 
Communications Facility. The buffers you define for the Communications Facility 
line station and the Communications Manager message path program must be large 
enough to handle the largest block that will be transmitted. 

The Communications FaciUty has no end-to-end protocol between nodes. If you 
require message integrity, you must implement it within the application programs in 
communicating nodes. 
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X.25 lOCP, $.IO0AB8 

The X.25 lOCP allows communication between a Series/ 1 and X.25 data terminal 
equipment (DTE) through a high-level data link control (HDLC) line, with or 
without an intervening X.25 packet-switching network. The DTEs may be other 
Series/ Is, other computers, or devices. The X.25 lOCP communicates over the 
HDLC line through the EDX X.25/HDLC Communications Support XHCS 
licensed program (Program Number 5719-HD2), using LAPB procedures and X.25 
packet level protocol. The lOCP can manage multiple HDLC lines. There may be 
multiple circuits (logical channels) on each line. 

You can use the lOCP in these ways: 

• To route messages over an HDLC line between stations in one Series/ 1 and 
stations in another Series/ 1 where the X.25 lOCP is running. See "Example 
12: X.25 Connection between Series/ Is" on page 382. The example explains 
how a message is routed from its origin in the local Series/ 1 to its destination 
in the remote Series/ 1 . 

• To route messages through an X.25 packet-switching network between stations 
in one Series/ 1 and stations in another Series/ 1 where the X.25 lOCP is 
running. See "Example 13: X.25 Connection Between Series/ Is through an 
X.25 Network" on page 392. 

• For communication between Series/ 1 application programs and computers or 
devices that function as X.25 DTEs. See "Example 14: X.25 Connection 
between a Series/ 1 and DTEs" on page 406. 

Refer to the CCITT Recommendation X.25 if you need more detailed information 
on the procedures and terms used to describe the X.25 lOCP. Terms not defined 
by Recommendation X.25 that are used in this section are: 

X.25 control packet 

An X.25-defined packet other than a data packet; for example, a call 
request packet or a reset indication packet. 

X.25 control message 

A fixed format message used within a Communications Facility node 
that contains information corresponding to an X.25 control packet. 

X.25 control message link 

A station that receives X.25 control messages. It may be a circuit 
station's direct or alternate link, as explained in "Station Definitions" 
on page 91. 

X.25 header 

A header prefixed to messages sent and received by the X.25 lOCP 
(both data and control) that identifies the message type. It is present 
only within a Communications Facility node. 

The chapter "Writing an X.25 Application Program" in the Programmer's Guide 
gives the format of the X.25 header and X.25 control messages and guidelines for 
writing a program that communicates with X.25 DTEs. 
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Hardware Requirements 



The X.25 lOCP has no hardware requirements other than those of the 
Communications FaciUty and XHCS. 



EDX Requirements 



XHCS Definitions 



XHCS is a prerequisite for the X.25 lOCP. The requirements it imposes on EDX 
are described in the XHCS Programming and Operating Reference. 



You must define the XHCS protocol descriptor and vector table (PDVT) and the 
device descriptor modules (DDMs) for the Communication Facility's use. You 
define the PDVT with XHCPROT statements. You define DDMs with the 
$XHCUT1 utility. The XHCPROT statement and the $XHCUT1 utility are 
described in the XHCS Programming and Operating Reference. 



PDVT Definitions 



The PDVT describes the link and packet protocol characteristics. You define these 
characteristics to XHCS by editing the XHCS data set ($XHCPROT), assembUng 
it, and link-editing the object module with the XHCS object modules to create 
$XHCS. The protocol characteristics cannot be changed dynamically. 

You must specify the following parameters in the XHCPROT statements for hnes 
used by the Communications Facility: 

• The first positional parameter must be PACKET. 

. LNKPROT must be LAPB. 

. PKTPROT and NODTYP depend on whether or not the X.25 connection has 
an intervening X.25 packet-switching network. 

- If you are connecting two Series/ Is without an intervening X.25 
packet-switching network, one of the Series/ Is must have PKTPROT of 
DCE and NODTYP of X25DCE and the other Series/ 1 must have 
PKTPROT of DTE and NODTYP of X25DTE. 

- If you are connecting a Series/ 1 to an X.25 DTE without an intervening 
X.25 packet-switching network, PKTPROT must be DCE and NODTYP 
must be X25DCE. 

- If you are connecting a Series/ 1 to an X.25 packet-switching network, 
PKTPROT must be DTE and NODTYP must be X25DTE. 
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DDM Defimtioiis 



You must use the XHCS utility $XHCUT1 to create a DDM for each line. The 
name you give the line will be the name of your Communications Facility line 
station. 

For a line used by the Communications Facility, you must define: 

. LEVEL as PACKET 
• TIMEOUT as 
. RDGRPSasl. 



Station Definitioiis 






Define stations to represent: 

• ThelOCP. Name=$.IO0AB8, type«USER. 

• Each HDLC line. Name^ddnmame, as defined to XHCS in the device 
descriptor module (DDM). Type=LINE; subtype«DCE or DTE. 

• Each logical channel to be used. 

Type=CIRCUrr; subtype=PVC or SVC. Usage is one of the following: 

— CF if you are using the circuit to route messages between Series/ Is. 

- STD if you are using the circuit to exchange data messages with an X.2S 
DTE. 



— STD+ if you are using the circuit to exchange data and X.25 control 
messages with an X.2S DTE. 

If you are using circuit stations with usage CF to route messages between 
Series/ Is, define stations to represent: 

• Each remote node to which local stations will send messages. Type«NODE; 
subtypes CF. 

• Each remote station to which local stations will send messages. 

Link the node station to the circuit station. Link the other remote stations as 
required for the communication you want. Be sure that each node has a unique 
node assignment and that the network address of the remote station is the same as 
the network address of the corresponding real station in the remote node. 

If you are using circuit stations with usage STD or STD+ for communication 
between application programs and X.25 DTEs, define stations to represent the 
application programs. Link the stations as follows, according to the circuit station's 
usage type: 

• STD: Link the circuit station to the station that is to receive data messages 
through this logical channel. 

• STD+: If you have one station that is to receive both data and control 
messages, link the circuit station to that station, using the direct link vector. If 
you have one station that is to receive only data messages and another station 
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that is to receive only control messages, link the circuit station to the first jr~^ 

station (data only) using the direct link vector; link the circuit station to the (|3 

second station (control only) using the alternate link vector. 



lOCP Operation Overview 



The X.25 lOCP consists of one main task and three subtasks for each started line 
station. The main task processes commands to stop or halt the lOCP and 
commands to start, stop, or halt the line stations. The three subtasks are: 

• The open subtask, which processes commands to start and stop circuit stations; 
opens and closes the circuits; and establishes and terminates virtual calls. 

• The read task, which processes messages that are read from the line and sends 
them to the appropriate destination. 

• The write task, which processes messages sent to the circuit station associated 
with the line. 

XHCS handles all transmission over the HDLC line. It manages X.25 protocol, 
pacing, and error recovery. 



Establishing Communication 



Permanent Virtual Circuits 



To establish communication through a logical channel, start the line station and the 

circuit station that represents the logical channel. If the circuit station has usage (f\) 

CF, set the node assignment and start the node station that represents the remote ^^ 

node to be accessed through the logical channel. If the circuit station has usage 

STD or STD+, start the circuit station's direct link. If the circuit station has usage 

$TD+, start the circuit station's alternate link, if it has one. 

When the X.25 lOCP or a DTE or DCE line station is started, the main task of the 
IOC? loads $XHCS, if it is not akeady loaded. When a DTE or DCE line station 
is started, $XHCS loads the associated device descriptor module (DDM) into its 
partition. If you let the X.25 lOCP load $XHCS, it may be loaded into a partition 
that has insufficient space for all the DDMs to be loaded. You can avoid this 
problem by loading $XHCS yourself into the partition you want before you start 
the X.25 lOCP or any DTE or DCE line station. The partition into which you load 
$XHCS must be static. 



When you define a permanent virtual circuit (a circuit station with subtype PVC), 
you specify the ED of the logical channel through which messages wiU be 
transmitted. If you are connecting two Series/ Is without an intervening X.25 
packet-switching network, you must specify the same logical channel ID in both 
Series/ Is. U you are connecting two Series/ Is through an intervening X.25 
packet-switching network, you must specify a logical channel ID that the X.25 
packet-switching network will connect to the Series/ 1 you want to communicate 
with. 

When a circuit station with subtype PVC is started, the lOCP opens the logical ^j^i 

channel specified in the station definition. If the other end of the logical channel is 
also open, data can flow through the logical channel. If the other end of the logical 
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Switched Virtual Circuits 
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channel is not open and an attempt is made to transmit data, the lOCP receives a 
reset indication packet. If the circuit station has usage STD+, the lOCP sends a 
reset indication control message to the circuit station's X,25 control message link. 



When a switched virtual circuit (a circuit station with subtype SVC) is started, a 
virtual call must be estabUshed before data can flow. A virtual call is a logical 
connection through the X.25 packet-switching network. Unlike permanent virtual 
circuits, circuit stations with subtype SVC do not have logical channels specified in 
the station definition. During virtual call estabUshment, a logical channel is 
assigned to the circuit station by $XHCS. The connection between logical 
channels is done by the X.25 packet-switching network. 

Virtual call establishment depends on the contact parameter defined in the circuit 
station: 

• WAIT: When the circuit station is started, the lOCP opens the circuit and 
waits for an incoming call packet from the network. When an incoming call 
packet arrives, $XHCS determines if the caUing address and protocol ID match 
those defined for the circuit station. If they do, it passes the incoming call 
packet to the lOCP. 

If the circuit station has usage CF or STD, the lOCP transmits a call accept 
packet to the network, and the virtual call is established. 

If the circuit station has usage STD+, the lOCP sends an incoming call control 
message to the circuit station's X.25 control message Unk and waits for a 
response to be sent to the circuit station. If the response is a call accept 
control message, the lOCP transmits a call accept packet to the network, and 
the virtual call is established. If the response is a clear request control message, 
the lOCP transmits a clear request packet to the network. When a clear 
confirmation packet arrives from the network, the lOCP closes the circuit and 
sends a clear confirmation control message to the circuit station's X.25 control 
message link. 

• INIT: When the circuit station is started, the lOCP uses the station's call ID to 
obtain an X.25 network address from data set $.SYSX25. It transmits the 
X.25 network address and the protocol ID and user data defined in the circuit 
station to the network in a call request packet. When the network responds 
with a call connected packet, the virtual call is established. If the circuit station 
has usage STD-h, the lOCP sends a call connected control message to the 
circuit station's X.25 control message link. If there is no CALLID specified for 
the station, the network must be able to obtain the X.25 network address to 
call by using other facilities. 

If the network does not respond with a call connected packet within the time 
specified in Recommendation X.25, or if the network responds with a clear 
indication packet, the lOCP closes the circuit. If the circuit station has usage 
STD-H, the lOCP sends a clear indication control message to the circuit 
station's X.25 control message link. 

• USERINIT: When the circuit station is started, the lOCP takes no action until 
a call request control message is sent to the circuit station. The lOCP uses the 
information in the call request control message to build a call request packet 
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and transmits it to the network. From this point on, call establishment occurs 
in the same way as for circuit stations with contact INIT. 

You cannot define contact USERINIT for a circuit station with usage CF. 
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Sending Messages 



Receiving Messages 



When a message is placed on a circuit station's queue, the lOCP retrieves it and 

passes it on to $XHCS for transmission over the HDLC line. 

How the lOCP handles the data varies according to the circuit station usage: 

• CF: the lOCP obtains the 24-b3^e Communications FaciUty message header 
and appends the message data to it. $XHCS transmits the message header and 
data as X.25 data packets. 

• STDorSTD+: the lOCP determines whether the message is data or control 
information from its Communications FaciUty message type: 

— A Communications Facility data message (one received with return code 
- 1 ) is data information. 

— A Communications Facility status message (one received with return code 
+6) is control information. 

In either case, the message must begin with an X.25 header, which the lOCP uses 
to determine the type of control information. The lOCP removes the X.25 header 
before passing the message on to $XHCS. $XHCS transmits data information as 
X.25 data packets and control information as X.25 control packets. 



$XHCS reads data from the HDLC line and passes it on to the lOCP. $XHCS 
provides a pointer to the circuit station associated with the logical channel over 
which the data was read. (The pointer is defined by the lOCP when it opens a 
circuit.) $XHCS also provides an indication of the X.25 packet type — whether it is 
data or control information. 

The lOCP processes the data according to its type and the circuit station usage. 

• If usage is CF or STD and the data is control information, the lOCP logs its 
receipt and responds as required, but it does not send the data on. 

• If usage is STD+ and the data is control information, the lOCP logs its receipt, 
prefixes it with an X.25 header, and sends it as a Communications Facility 
status message. The destination is the circuit station's alternate link, if it has 
one; otherwise the destination is the circuit station's direct link. 






If usage is CF and the data is data information, the lOCP assumes that first 24 
bytes are a Communications Facility message header. It sends the message 
header and data to the message dispatcher. The message dispatcher dispatches 
the message according to the destination information in the message header. 

If usage is STD or STD+ and the data is data information, the lOCP prefixes it 
with an X.25 header and sends it as a Communications Facility data message 
to the circuit station's direct link. 
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If the lOCP's user station has a direct link or an alternate link (user intercept 
processing is in effect), then, after determining the message destination, the lOCP: 

• Builds a Communications Facility message header that includes the message 
destination and appends the data or control information to the message header. 

• Sends the message header and data information as a Communications FaciUty 
data message to its direct link. 

• Sends the message header and control information as a Communications 
FaciUty status message to its alternate link, if it has one; otherwise, sends them 
to its direct Unk. 



Terminating Communication 






Restrictions 



Data flow through a permanent virtual circuit stops when the circuit station is 
stopped. 

A virtual call is terminated in the following ways: 

• An SVC circuit station is stopped. The lOCP transmits a clear request packet 
to the network and waits for a clear confirmation packet. When the clear 
confirmation packet arrives, the lOCP closes the circuit. 

• A clear request control message is sent to an SVC circuit station with usage 
STD+. The same actions occur as when the station is stopped. In addition, 
the lOCP sends a clear confirmation control message to the qircuit station's 
X.25 control message link. 

• The lOCP receives a clear indication packet from the network for a switched 
virtual circuit. If the circuit station usage is STD+, the lOCP sends a clear 
indication control message to the circuit station's X.25 control message Unk. 

If the virtual caU is terminated by a clear request control message or a clear 
indication packet, the circuit station may remain active depending on its contact 
type and mode. If the circuit station contact type is INIT and the station is in 
STOP mode (which is the default), the lOCP stops the station. In aU other cases 
(contact type WAIT, contact type USERINIT, or contact type INIT with RETRY 
mode), the station remains active. Another virtual caU can then be estabUshed, as 
explained in "Establishing Communication" on page 92. 



You can have only one active Local Communications Controller connection, BSC 
point-to-point connection, or X.25 connection through circuit stations with usage 
CF between two Series/ Is. 
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The X.25 lOCP has the same restrictions as XHCS. Some of these are: 

• Conformance to CCITT Recommendation X.25 as amended in 1980 

• No datagram support 

• No reject packet support. 

The X.25 lOCP does not support diagnostic packets. 

The X.25 lOCP provides limited data circuit-terminating equipment (DCE) 
support. Only permanent virtual circuits are supported for DCE hues. A Series/ 1 
where the X.25 lOCP is running cannot be used as an X.25 packet-switching 
network, nor can it be part of an X.25 packet-switching network. 

The X.25 lOCP provides limited D-bit support. Because the Communications 
Facility has no end-to-end protocol between nodes, the X.25 lOCP sends the 
delivery confirmation packet after successful completion of the Communications 
Facility SEND instruction. Communications Facility appUcation programs cannot 
send D-bit data messages. If you require message integrity, you must implement it 
within the application programs in the communicating nodes. 

Remote IPL and remote disk are not supported over an X.25 connection. 
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3270 Control lOCP, $.IO0AC0 

The 3270 control lOCP manages communication with physical 3270 control units, 
Series/ Is emulating 3271 control units, 5280 Distributed Data Systems running in 
3270 emulation mode, or System/38s running in 3270 emulation mode. The 
connection is a leased or switched binary synchronous communications (BSC) line, 
operating in multipoint mode. The lOCP can manage multiple lines. There may be 
up to 32 control units, each with up to 32 terminals and printers, associated with 
each line. 

Data passing between the lOCP and the real or emulated 3270 system is in 3270 
data stream format. The lOCP uses standard BSC multipoint protocol, as 
described in An Introduction to the IBM 3270 Information Display System, 

GA27-2739. 

You can use the lOCP in these ways: 

• For communication between host programs and 3270 printers or terminals 
attached to the Series/ 1. See example 3 in the chapter "Sample 
Configurations" on page 269. 

• For communication between Series/ 1 programs and 3270 printers or terminals. 

• For communication between Series/ Is, when this lOCP is running in one 
Series/ 1 and the 3270 emulation lOCP ($.IO0AE0) is running in the other 
Series/ 1. See example 7 in the chapter "Sample Configurations" on page 269. 
The example explains how a message is routed from its origin in one node to its 
destination in another node. 

• To IPL a remote Series/ 1 that is connected to the BSC line and strapped as a 
multipoint tributary station that can be IPLed. 

• To enable a remote Series/ 1 that is connected to the BSC Une to access disks 
attached to the local Series/ 1. The remote Series/ 1 must have remote disk 
support in the EDX supervisor, but the Communications Facility need not be 
running. 

The lOCP can manage these control units: 

3271 model 1 or 2 

3276 model 1,2, 3, or 4 

3274 model IC, 21C, 31C, 41C, 51C, or 61C 

Series/ 1 emulating a 3271 control unit 

5280 Distributed Data System running in 3270 emulation mode 

System/38 running in 3270 emulation mode. 

The terminals and printers that can be attached to these control units are described 
in the 32 70 Introduction. The Communications Facility does not support the 3270 
extended color or extended highlighting features. Restrictions on the support of 
screens larger than 1920 characters (24 rows of 80 columns) are explained in the 
section "Restrictions" on page 101. 
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Hardware Requirements 



Use of this lOCP requires a Series/ 1 BSC adapter (feature number 2074, 2075, or 
2093/2094), or a multifunction attachment (feature number 1310). 

Strap the BSC adapter (jumpers on or off) as follows, according to the type of 
connection: 



£DX Requirements 



DTR No Ring Switched Line 

Inhibit (MP address bit 7) 



Leased Line 


on 


on 


off 


Switched Manual 


on 


on 


off 


Switched Auto- Answer 


off 


off 


on 



Multipoint 
Tributary 

off 
off 
off 



You may need to install other jumpers, depending on the type of modem, as 
explained in the Binary Synchronous Features Description. 



Include EDX BSC support in the EDX supervisor. Use the BSCLINE statement to 
define each BSC line. Specify TYPE=MC if the line is leased, TYPE=SM if the 
line is switched manual, or TYPE=SA if the Une is switched auto-answer. 



Station Definitions 



Define stations to represent: 

. ThelOCP. Name=$.IO0AC0, type=user. 

• Each BSC line. Type=line, subtype=3271C. 

• From 1 to 32 control units for each line. Type = terminal, subtype=3271. 

• From 1 to 32 terminals or printers for each control unit. Type = terminal, 
subtype=3277 (terminal) or 3286 (printer). 

Link each station that represents a terminal or printer with a station that represents 
an emulated terminal or printer or an application program. No hnks are required 
for the line stations or the stations that represent control units. 






lOCP Operation Overview 



The 3270 control lOCP consists of one main task and a subtask for each started 
Une station. The main task processes commands to stop or halt the lOCP and 
commands to start, stop, or halt line stations. Each Une subtask processes data 
received from the terminals on the line and messages sent to the terminal stations 
associated with the line station. 

The lOCP acts as a multipoint control station. It issues general poUs to soUcit data 
from terminals. It issues a specific poll only to receive 3270 status information 
when a control unit indicates that there is status pending for a terminal or printer. 
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Input data and 3270 status messages contain the polling address of the device from 
which the data originated. The lOCP sends data as a Communications Facility 
message, specifying the terminal station with the indicated polling address as the 
origin. If the lOCP has a direct link vector, it specifies that station as the 
destination; otherwise, it specifies a null destination. 

When the lOCP has polled all control units, it processes pending output for each 
terminal station associated with the line station. It retrieves a message from a 
terminal station's queue, issues a selection sequence using the station's selection 
address, and sends the data. It continues sen(^g data until the station's message 
queue is empty, then proceeds to the next terminal station. When it has processed 
all pending output, the lOCP resumes polling. 

If the maximum retry value has not been set in the control unit station with the CP 
F RETRY command, the control unit will continue to be polled and performance 
may be affected. If the retry maximum has been set and the maximum number of 
retries has been reached, the control unit station will be set iaactive. The control 
unit will not be polled until the control unit station is restarted. 



Input from Terminals 






Basic Mode Input 



Record Mode Input 



Input from terminals may be one or more blocks of data. The lOCP accumulates 
the input data until it receives a block that ends with ETX. If the data begins with 
X'1002' (DLE/STX), the lOCP removes the DLE before processmg the data. 

If the terminal station that represents the device from which the data originated is 
in non-display mode and the data does not begin with DLE/STX, the lOCP 
translates lowercase characters to uppercase. If the station is in text mode, or the 
data begins with DLE/STX, the lOCP doesn't translate the data. 



If the terminal station is in basic mode, the lOCP processes input data as described 
in the preceding paragraphs and then sends the message to its destination. 



If the terminal station is in record mode, the lOCP processes input data according 
to its content. 

If the data is a 3270 status message, the lOCP discards it. 

If the data is a short read (one ended by the CLEAR key or a PA key), the lOCP 
sends the terminal a data stream that clears the screen, displays "READY" in row 
22, and unlocks the keyboard. 

In all other cases, the lOCP removes the following bytes from the input data: 

• The last byte (ETX) 

• The first 6 bytes (STX, polling address, attention ID, cursor address) 

• The seventh through ninth bytes, if the seventh byte is SBA (set buffer 
address). 
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If there is any data left, the lOCP sends it to its destination and sends the terminal 
a data stream that makes rows 23 and 24 an unprotected field, positions the cursor 
at row 23, and unlocks the keyboard. 



Xp 



Entering Commands 



You can enter CP or PD commands from a 3277 terminal, as follows: 

1. Press the CLEAR and RESET keys at the same time. This places the terminal 
in unformatted mode without sending data to the Series/ 1. 

2. Type the coromand in uppercase. If you enter a PD command, include the 
prefix CP. If you enter a command that displays information (such as CP Q) 
and you want the display to appear at your terminal, specify the terminal's 
station name as the destination parameter. The destination does not default to 
the terminal where the command was entered, as it does when you enter 
commands at an EDX terminal. 

3. Press the TEST REQ key. The lOCP wiQ receive the data, remove the test 
request header, and send the command to the command processor. 

You can't enter commands from 3276, 3278, or 3279 terminals, because they don't 
have the RESET/CLEAR capability. 



Output to Terminals 



When the lOCP receives a message destined for a terminal station, it sends the 
message on to the terminal or printer that the station represents. The messages 
may contain bmary data, remote IPL data, basic mode data, or record mode data. 



Binary Output 



Remote IPL Output 



Basic Mode Output 



If a message begins with DLE/STX (X'1002'), the lOCP removes ETX (X'03'), if 
there is one, from the end and sends the data with a ESC transparent write 
command. You can transmit binary data only to an emulated terminal. A real 
3270 system rejects data that starts with DLE. 



If a message begins with DCl/DCl (X'l 1 IT), the lOCP assumes the message is 
an IPL bootstrap. It inserts the terminal station's 3270 control unit address and 
sends the data. This causes an IPL of the remote Series/ 1 whose BSC adapter is 
strapped with that control unit address. 



If a message begins with STX/ESC (X'0227'), the lOCP assumes the message is a 
3270 data stream. It checks that the third byte is a vahd, supported 3270 
command code. The supported commands are: erase all unprotected, read 
modified, read buffer, write, erase write, and erase write alternate. If the last byte 
of the message is an ETB (X*26'), the lOCP replaces it with ETX. If the last byte 
is neither ETB nor ETX, the lOCP appends an ETX. 
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Record Mode Output 
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If a message doesn't begin with DLE, DCl, or STX, the lOCP formats it as a 3270 
data stream before sending it. If the data is for a printer, the lOCP appends an 
ETX to the end of the message and the following 4 bytes to the beginning of the 
message: 

X'02' STX 

X'27' ESC 

X'F5' Erase/ write command 

X'F8' Write control character for 80-character print hne 

If the data is for a terminal, the lOCP appends 9 bytes to the beginning of the 
message: 

X'02' STX 

X'27' ESC 

X'Fl' Write command 

X'C3' Write control character that unlocks the keyboard and resets 

modified data tags 

X'llxxxx' A set buffer address sequence, such that the first output message 
appears on row 1 of the screen, the second on row 2, and so on, 
wrapping around from row 21 to row 1. If the operator enters data, 
it is processed as described in "Input from Terminals" on page 99, 
and output resumes at row 1 . 

X' 1D40' Start field order for an unprotected field 

The lOCP also appends 4 bytes to the end of the message: 

X'125B5F' Erase unprotected to row 22, column 80 

X'03' ETX 



Restrictions 



The lOCP does not support the 3270 copy command. 

The lOCP does not support the 3270 write structured field command. 

The lOCP does not support the sending of multiblock messages to terminals. It 
handles each message sent to a terminal station as a single complete message. 

The lOCP does not support the TEST REQ key, except as described in "Entering 
Commands" on page 100. 

Neither the lOCP nor the Communications Facility language extensions support 
the 3270 extended color or extended highlighting features. 
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The lOCP supports screens larger than 1920 characters (24 rows of 80 characters), 

but other components of the Communications Facility do not. The panel design 

aid, $.PANEL, supports only 1920-character screens. The language extensions ^r^ 

support larger screens to a limited extent — the GET and PUT instructions assume i B 

that a field starting at screen location 1919 wraps around to location 0. 
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Series/l-to-System/370 Channel Attach lOCP, $.IO0AD0 



The Series/ l-to-System/370 channel attach lOCP allows you to connect a 
Series/ 1 and a host processor in such a way that the Series/ 1 appears to the host 
as a local 3272 control unit with terminals and printers. The lOCP can manage 
multiple channel attachments to the same or different host processors. There may 
be up to 32 emulated terminals and printers associated with each channel 
attachment. 



Applications running in the host communicate with the Series/ 1 the same way they 
communicate with an actual local 3270 system, as described in the 3271 Guide. 
Although the lOCP operates as a local system, it sends and receives 3270/BSC 
data stream messages. It removes BSC and 3270 control characters from messages 
before sending them to the host. It appends BSC and 3270 control characters to 
messages received from the host before sending them to their destination. 

You can use the IOC? in these ways: 

• For communication between host programs and terminals or printers attached 
to the Series/ 1. See example 2 in the chapter "Sample Configurations" on 
page 269. 

• For communication between host programs and Series/ 1 programs. 



Hardware Requirements 



Use of this IOC? requires the IBM Series/ 1 -System/370 channel attachment, 
which consists of: 

• IBM Series/ 1 -System/370 Channel Attachment (feature number 1200) 

• IBM 4993 model 1 Series/ 1 -System/370 Termination Enclosure. 



EDX Requirements 



Station Definitions 



Include EDX EXIO support in the EDX supervisor. Use the EXIODEV statement 
to define each channel attachment. 



Define stations to represent: 

. ThelOCP. Name = $.100 ADO, type=user. 

• Each channel attachment. Type = line, subtype =C A. 

• From 1 to 32 emulated devices for each channel attachment. Type = terminal, 
subtype=port. 

Link each station that represents an emulated device with a station that represents 
a real terminal or printer or an application program. No link is required for line 
stations. 
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lOCP Operation Overview 



The channel attach lOCP consists of one main task and two subtasks for each 
started line station — a message task and an attention task. The main task 
processes commands to stop or halt the lOCP and commands to start, stop, or halt 
line stations. Each attention task processes commands and data received from the 
host. Each message task processes messages sent to the terminal stations 
associated with the line station. 

When a message is available at one of the terminal stations, the message task issues 
a set attention command to notify the host that data is available. When the host 
program is ready to receive the data, it issues a read modified command, specifying 
the appropriate port number. The attention task responds by receiving a message 
from the queue of the station with that port number and writing it to the host. 

The host transmits data to the Series/ 1 by issuing an erase/write, an erase/write 
alternate, or a write command for a particular port. The attention task locates the 
terminal station with the specified port number. It receives the data and sends it as 
a Communications Facility message, specifying the terminal station as the origin. If 
the lOCP has a direct link vector, it specifies that station as the destination; 
otherwise, it specifies a null destination. If the host selects an undefined port or 
one whose terminal station is stopped, the lOCP returns an intervention required 
indication to the host. 

Because of hardware timing constraints, the lOCP doesn't process a read buffer 
command or an unsolicited read modified command as a real 3272 control unit 
does. (An unsolicited read modified command is one sent by the host without the 
host's having received an attention interrupt indicating that data is available.) 

When the terminal station is in basic mode, the lOCP sends the command to its 
destination and waits for a response. The hardware will time-out if a response is 
not received within 480 milliseconds. If a hardware time-out occurs, the host may 
retry the command or issue a new command. If the host issues a new command, it 
will ignore any response to the previous read. The lOCP's processing of the 
terminal's message queue after the time-out depends on the host command 
received: 

• If the host reissues the read buffer or read modified command, the port has an 
additional 480 milUseconds in which to respond. (This is considered a retry.) 

• If the host issues a command to a different port, the late response to the 
original read command is saved on the queue. It will be sent as the response if 
the host retries the original command. 

• If the host issues a second command to the original port, and the command is 
different from the first (other than SELECT), the lOCP purges the response to 
the first command. (This action is considered a give-up.) 

When the terminal station is in record mode, the lOCP responds to read buffer and 
unsolicited read modified commands by sending the data stream stream X'7D4040' 
to the host. This data stream is what results when a 3277 operator presses the 
ENTER key with a blank screen and the cursor at row 1, column 1. 
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Messages from the Host 



Basic Mode Input 



Record Mode Input 



g^\ 



Printer Operation 



The lOCP modifies data received from the host before sending it on to its 
destination. 



If the terminal station is in basic mode, the lOCP builds a data stream that looks 
like those sent by the 3270 emulation lOCP. The data stream begins with 
STX/ESC (X'0227') and one of the following command codes: 



X'Fl' 


Write 


X'F2' 


Read Buffer 


X'F5' 


Erase/Write 


X'F6' 


Read Modified 


X'6F' 


Erase All Unprotected 



This is followed by the data received from the host for a write or an erase/write 
command. The first byte of the data is a write control character. 

In all cases, ETX (X'03') is appended to the end of the message. 

You can use the lOCP to transmit binary data between a host program and a 
Series/ 1 program. The Series/ 1 program should be written to ignore the control 
information that the lOCP appends. 



If the terminal station is in record mode, the lOCP ignores an erase all unprotected 
command. It removes the following control information from the data for a write 
or an erase/write command: 

• The first byte (write control character) 

• The second through fourth bytes, if the second byte is SBA (set buffer 
address) 

• The fifth and sixth bytes, if the second byte is SBA and the fifth byte is SF 
(start field) 



Host programs can send messages to a printer through a terminal station that is 
Unked to a station that represents a printer. The lOCP may notify the host that the 
message has been received before the message has a chance to be printed. As a 
result, the host may send printer messages at a higher rate than the printer can 
handle. To avoid this problem, you should define disk queuing for any printer that 
will be receiving messages from a host system over a channel attachment. 
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Messages to the Host 



The lOCP sends the host data messages that were sent to terminal stations. It 
modifies messages before sending them, according to whether they contain basic 
mode or record mode data. 






The lOCP discards 3270 status messages, messages that begin SOH/%/R/STX 
(X'016CD902'). It issues a log message to report the status information, except 
when the status is device end. 



Basic Mode Output 



Non-BSC Output 



If a message begins with DLE/STX (X*1002') or STX (X'02'), the lOCP assumes 
that it is a correctly formatted 3270 data stream. It removes the DLE (if any), the 
STX, and the next 2 bytes (the 3270 polling address). The lOCP removes the last 
byte of the message if it is ETB (X'26') or ETX (X'03'). 



If a message doesn't begin with DLE or STX, the lOCP appends 3 bytes to the 
beginning of the message: 

X'7D' ENTER key attention ID 

X'4040' Cursor location (row 1, column 1) 



w 



Restrictions 



The lOCP supports remove mode, which is described in the section "Remove and 
Non-Remove Modes" on page 76, but only for ports operating in basic mode. 

Host programs should issue read buffer commands and unsolicited read modified 
commands only to a port operating in basic mode. Because of timing 
considerations, the host should issue these commands only when the destination is 
on a Series/ 1 that is attached to the host. If the port is not in basic mode, the host 
receives the message X'7D4040'. 

The lOCP does not support the diagnostic read command. 

The lOCP does not support the sending of multiblock messages to the host. It 
handles each message sent to an emulated terminal station as a single complete 
message. 

The lOCP does not provide any message mapping services except as described for 
record mode output. If the data going to the host is to be processed by any host 
mapping services, the appropriate 3270 orders must appear in the data stream. 
Messages created by real 3270 devices or by 4978/4980/3101/7485 devices as 
supported by the Communications Facility are formatted correctly. If a user 
program creates messages, it must format those messages correctly. 
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The lOCP does not save the last message sent to the host. Therefore, if a read by 
the host fails, any retry is the responsibihty of the program that manages the station 
that is communicating with the host: 

• If the host is communicating with is a local Series/ 1 terminal, input data is 
available for retry until a write command is received or until the terminal user 
presses RESET and enters new data. 

• If the host is communicating with a real 3270 device, input data is available for 
retry in the device's hardware buffer. The time that it takes to retransmit the 
data will probably cause the channel to time-out. It it does, a user application 
between the channel attach and 3270 control lOCPs is required. 

• If the host is communicating with an application program, the user application 
must provide the function of saving the message. 

• If the host is communicating with a terminal on a downstream Series/ 1, a user 
application between the channel attach lOCP and the downstream Series/ 1 
can be written if message saving is required. 

• If the host is communicating with the program dispatcher, a user application 
between the host and the channel attach lOCP is required, because the 
program dispatcher does not save transactions for retransmission. If the 
program dispatcher receives a read buffer or read modified command, it 
discards the command because the command isn't a transaction. 



Performance Considerations 






^f ™ 



When a host application sends data too rapidly to the Series/ 1 through the channel 
attachment, the attachment may time out. To avoid this, the Series/ 1 should pace 
the host program. Any convenient pacing technique may be used; such as, sending 
an acknowledgement from a Series/ 1 application to the host. 

Defining the channel attach terminal station as disk-queued or linking the station to 
a disk-queued station is a good method to avoid filling the Communications Facility 
buffer pools during large and high-speed transmissions of data. However, the 
additional overhead of disk I/O may cause time-outs during those transmissions. 
To avoid this problem, position $.SYSNET and the disk-queue data sets to promote 
the quickest retrieval. The following suggestions are listed in order of 
effectiveness: 

. Locate $.SYSNET on a fixed-head disk. 

• Locate $.SYSNET and the disk-queue data sets on different devices. 

• Locate $.SYSNET and the disk-queue data sets close together on one device. 

If you still have time-out problems, try pacing the host transmission. 

When possible^ the channel attachment feature card should be located adjacent (or 
as close as possible) to the processor card or cards. This technique minimizes time 
delays in processing channel attachment I/O. 

If most of your messages are short ones, it may seem to you that the channel is 
busy for an excessive amount of time. This is because the Series/ 1 channel 
attachment card, unlike the real 3272 control unit, is an unbuffered device. This 
requires the channel to stay in a busy state from the time the host issues an I/O 
command until the data transfer is complete and the attachment presents 
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channel-end and device-end to both the host and the Series/ 1. The same sequence 
is required for short as well as long messages; therefore, you might notice its effect 
more when the messages are short. 4^^ 

Unsolicited read commands may cause time-outs unless you provide a program to 
handle them, as discussed in the section "Restrictions" on page 106. Some host 
systems issue an unsolicited read command because their buffer is shorter than the 
message sent from the Series/ 1 . If you experience time-outs on long messages, and 
your host system allows you to control the size of its buffers, increase the buffer 
size to that of the longest message sent from the Series/ 1 (plus the size of any host 
access method headers). 
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The 3270 emulation lOCP allows you to connect a Series/ 1 and a host processor in 
such a way that the Series/ 1 appears to the host as a 3271 model 2 control unit 
with terminals and printers. The connection is a leased or switched binary 
synchronous communications (BSC) Une, operating in multipoint mode. The lOCP 
can manage multiple connections to the same or different host processors. There 
may be one emulated control unit and up to 32 emulated terminals and printers 
associated with each communication Une. 

Data passing between the Series/ 1 and the host is in 3270 data stream format, 
using standard BSC multipoint protocol. 

Applications running in the host communicate with the Series/ 1 the same way that 
they communicate with an actual 3270/BSC remote system, as described in the 
3271 Guide. 

You can use the lOCP in these ways: 

• For communication between host programs and terminals or printers attached 
to the Series/ 1. See example 1 in the chapter "Sample Configurations" on 
page 269. 

• For communication between host programs and Series/ 1 programs. 

• For communication between Series/ Is, when the 3270 emulation lOCP is 
running in one Series/ 1 and the 3270 control lOCP ($.IO0AC0) is running in 
another Series/ 1. See example 7 in the chapter "Sample Configurations" on 
page 269. The example explains how a message is routed from its origin in 
one node to its destination in another node. 

The host computers with which the Series/ 1 may be connected are IBM: 

Series/ 1 
System/370 
30jcx series 
4300 series 
8100 series 
System/3 
System/34 
System/7 



Hardware Requirements 



Use of this lOCP requires a Series/ 1 BSC adapter (feature number 2074, 2075, or 
2093/2094), or a multifunction attachment (feature number 1310). 
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EDX Requirements 



Station Definitions 



Strap the BSC adapter (jumpers on or off) as follows, according to the type of 
connection: 



Leased Line 
Switched Manual 
Switched Auto- Answer 



DTR 



on 
on 
off 



No Ring 
Inhibit 

on 
on 
off 



Multipoint 
Tributary 



,'^'\ 



on 
on 
on 



You must also strap the multipoint address with the host polling address for this 
tributary. If you want the adapter to respond to a remote IPL, bit of the address 
must be strapped on, so the host polling address must be 'Cn' or 'D«'. 

You may need to install other jumpers, depending on the type of modem, as 
explained in the Binary Synchronous Features Description. 

A multifunction attachment does not require strapping. Instead you specify the 
polling address in the POLL operand of the EDX BSCLINE statement. For 
example: 

P0LL=(C2) . 



Include EDX BSC support in the EDX supervisor. Use the BSCLINE statement to 
define each BSC line. Specify TYPE=MT if the Une is leased, TYPE=SM if the 
Une is switched manual, or TYPE=SA if the Une is switched auto-answer. 



Define stations to represent: 

. ThelOCP. Name=$.IO0AE0, type=user. 

• Each BSC line. Type=line, subtype=3271E. 

• One emulated control unit for each line. Type = terminal, subtype=3271. 

• From 1 to 32 emulated terminals or printers for each line. Type = terminal, 
subtype=3277 (terminal) or 3286 (printer). 

Link each station that represents an emulated terminal or printer with a station that 
represents a real terminal or printer or an application program. No Unks are 
required for the line stations or the stations that represent control units. 






lOCP Operation Overview 



The 3270 emulation lOCP consists of one main task and a subtask for each started 
line station. The main task processes commands to stop or halt the lOCP and 
commands to start, stop, or halt line stations. Each line subtask processes data 
received from the host and messages sent to the terminal stations associated with 
the line station. 



jK 
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The lOCP acts as a multipoint tributary station, responding to polling and selection 
sequences received from the host. It can operate in a general poll or specific poll 
environment. When the lOCP receives a general poll, it processes pending output 
for each terminal station associated with the line station. It retrieves messages 
from the terminal stations' queues and sends thein to the host. When the lOCP 
receives a specific poll, it processes pending output only for the terminal station 
with the specified polling address. 



If the host issues only specific polls, you shouldn't start terminal stations that won't 
be polled. If messages are sent to terminal stations that are never poUed and the 
messages are queued in storage, the message buffer pool can fill up, leaving no 
room for messages for other stations. 

When the lOCP receives a selection sequence, it locates the terminal station with 
the specified selection address. It then receives one or more blocks of data from 
the host and sends each one as a Communications Facility message, specifying the 
terminal station as the origin. If the lOCP has a direct link vector, it specifies that 
station as the destination; otherwise, it specifies a null destination. 



Messages from the Host 



Each block of data received from the host must begin with X'0227' (STX/ESC) or 
X' 100227' (DLE/STX/ESC) followed by a 3270 command code. If a block 
begins with DLE, the lOCP removes the DLE before processing the data. 



3270 Commands 






The only control command accepted is the erase all unprotected command. 

Three write commands are accepted: write, erase write, and erase write alternate. 
These commands require that a write control character immediately follow the 
command code. 



Basic Mode Input 






Two read commands are accepted for terminal stations in basic mode: read 
modified and read buffer. Both of these commands solicit terminal input. The 
lOCP sends the read command to its destination, receives the next message from 
the emulated terminal station's queue, and sends this message on to the host as a 
response to the read command. 

If the response does not arrive within a certain period of time, the lOCP terminates 
the request by sending an EOT to the host. The lOCP waits for a maximum of ten 
intervals of 500 miUiseconds each, for a total time of five seconds. You can use the 
CP F TIMEOUT command to set a different interval for a 327 IE Une station. 



If the selected terminal station is in basic mode, the lOCP sends the message 
unchanged to its destination (except for removing an initial DLE). 
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Printer Operation 



If the selected terminal station is in record mode, the lOCP reformats the data 
received from the host before sending it to its destination. The lOCP removes the 
following control information from the data: 

. The last byte (ETX) 

• The first 4 bytes (STX, ESC, command code, write control character) 

• The fifth through seventh bytes, if the fifth byte is SBA (set buffer address) 

• The eighth and ninth bytes, if the fifth byte is SBA and the eighth byte is SF 
(start field). 



When the lOCP receives data for an emulated printer station, with the start printer 
bit on in the write control character, it sends the message to its destination and 
then sends a WACK to the host, which indicates that the printer is busy. The host 
will not send more data for the printer until it receives a device end status message, 
which indicates that the printer is again ready. (If the host does select the printer 
again before receiving device end, it will receive a device busy status message.) 

The program that manages the real printer to which the emulated printer is linked is 
responsible for sending a device end status message to the emulated printer station 
when the print operation is complete. When the lOCP retrieves the device end 
status message from the printer station's queue, it turns off its indicator that the 
printer is busy and sends the status message on to the host. 

The program that manages the real printer is also responsible for retrying a print 
operation when the printer is not ready. The lOCP assumes that a print operation 
will complete successfully once it has sent the data to its destination. If the 
program that manages the real printer sends back an intervention required status 
message, the lOCP ignores it. 

The lOCPs that manage printers retry print operations, when necessary, and send 
the required device end status message. If you write an lOCP to manage printers 
or an appUcation program that processes data for emulated printers, you must do 
the same. The format of a status message is: 

. A 4-byte heading: SOH (X'01')/%/R/STX (X'02') 

• 2 bytes for the control unit and device address, which the 3270 emulation 
lOCP fills in 

• The 2-byte status/sense code; X'C240' for device end 
. ETX (X'03'). 






A.>^ 
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Messages to the Host 



Binary Output 



Basic Mode Output 



Record Mode Output 






The lOCP sends the host data messages that were sent to terminal stations. The 
messages may contain binary data, basic mode data, or record mode data. The 
lOCP also sends 3270 status messages to the host. 



If a message begins with DLE (X'lO'), the lOCP inserts the terminal station's 
polling address in the third and fourth bytes, removes ETX (X'03'), if there is one, 
from the end, and sends the message to the host with a BSC transparent write 
command. The host program is responsible for handling the data, deblocking it if 
necessary. 



If a message begins with STX (X'02'), the lOCP assumes that it is a correctly 
formatted 3270 data stream. The lOCP inserts the terminal station's poUing 
address in the second and third bytes. If the last byte of the message is ETB 
(X'26'), it replaces the ETB with ETX. If the last byte is neither ETB nor ETX, it 
appends an ETX. If the message is longer than 256 bytes, the lOCP sends it to the 
host in multiple blocks. 



If a message doesn't begin with DLE or STX, the lOCP formats it as a 3270 data 
stream before sending it to the host. It appends an ETX to the end of the message 
and the following 6 bytes to the beginning of the message: 

X'02' STX 

X'4040' Control unit and device address 

X'7D' ENTER key attention ID 

X'4040' Cursor location (row 1, column 1) 



3270 Status Messages 



The lOCP then handles the reformatted message as described for basic mode 
output. 



The lOCP sends 3270 status messages to the host to report error and exception 
conditions, as a real 3271 control unit does. The lOCP sends status messages to 
report conditions it detects. It also sends status messages that it retrieves from 
terminal stations' message queues. It detects status messages by the fact that they 
begin with SOH (X'Ol'). It sends status messages in response to a general or 
specific poll, according to the status condition. 

The 3270 status/sense codes for conditions detected by the lOCP are: 

Command Reject (X'4060'): The lOCP received an invalid or unsupported 3270 
command from the host, or it received a read command for a terminal station in 
record mode. 



o 



Device Busy (X'C840'): The lOCP received and processed a message for an 
emulated printer, with the start printer bit on in the write control character. It has 
not yet received device end status from the corresponding real printer. 
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Restrictions 






Device End (X*C240'): The status of a terminal station has changed from inactive 
to active. That is, the station has just been started or was stopped and then 
restarted. 

Intervention Required (X'4050'): The lOCP received a specific poll with an 
undefined polUng address, or it received a selection sequence for a terminal station 
that is stopped (its status is inactive), or it received a 3270 read command for a 
terminal station that has no active direct link. 

Operation Check (X'40Cr): The lOCP received data from the host that did not 
begin with X'0227' or X' 100227'. 



The lOCP does not support the 3270 copy command. 

The lOCP supports the chaining of write-type commands to a limited extent. Each 
chained write command that includes data should have an SBA (set buffer address) 
order immediately following the write control character. This restriction applies 
because the lOCPs that manage real terminals and printers don't keep track of the 
current buffer address between write commands. 

The lOCP does not accept multiblock messages for the host. It handles each 
message sent to an emulated terminal station as a single complete message. 

The lOCP does not provide any message mapping services except as described for 

record mode output. If the data going to the host is to be processed by any host 

mapping services, the appropriate 3270 orders must appear in the data stream. /f x 

Messages created by real 3270 devices or by 4978/4980/3 101/7485 devices as 1^^^ 

supported by the Communications Facility are formatted correctly. If a user 

program creates messages, it must format those messages correctly. 

The lOCP can be used only in a normal (EBCDIC) data mode, except when the 
host system supports transmission of binary data. Only EBCDIC data can be 
transmitted to or from the Series/ 1 when you're using IMS or CICS 3270 terminal 
support. 

The lOCP does not save the last message sent to the host. It expects that the host 
will solicit input by polling, as is recommended for remote 3270 configurations. If 
the host issues read commands (read modified or read buffer) to request 
retransmission of the prior message, the response to those commands is the 
responsibiUty of the program that manages the station that is communicating with 
the host: 

• If the host is communicating with a Series/ 1 terminal or a real 3270 device, 
input data is available for retransmission until a write command is received or 
until the terminal user presses RESET and enters new commands. 

• If the host is communicating with an apphcation program, the user apphcation 
must be prepared to retransmit the prior message if a read command is 
received. 

• If the host is communicating with a program dispatcher, a user application 
between it and the lOCP is required. The program dispatcher discards a read 
buffer or read modified command because it is not a transaction. 
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Series/l-to-Series/1 BSC lOCP, $.IO0A10 



The Series/ 1-to-Series/l BSC lOCP manages communication between two 
Series/ Is connected by a leased or switched binary synchronous communications 
(BSC) line, operating in point-to-point mode. The lOCP can manage multiple 
connections to different Series/ Is. 



You can use the lOCP in these ways: 

• To send messages from stations in one Series/ 1 to stations in another Series/ 1 
where $.IO0A10 is running. See example 6 in the chapter "Sample 
Configurations" on page 269. The example explains how a message is routed 
from its origin in one node to its destination in another node, 

• To IPL a remote Series/ 1 that is connected to the BSC Une and strapped for 
remote IPL. 

• To enable a remote Series/ 1 that is connected to the BSC line to access disks 
attached to the local Series/ 1 . The remote Series/ 1 must have remote disk 
support in the EDX supervisor, but the Communications Facility need not be 
running. 



Hardware Requirements 



Use of this lOCP requires a Series/ 1 BSC adapter (feature number 2074, 2075, or 
2093/2094), or a multifunction attachment (feature number 1310). 

Strap the BSC adapter (jumpers on or off) as follows, according to the type 
connection: 



DTR No Ring Switched Line Multipoint 

Inhibit (MP address bit 7) Tributary 



Leased Line on on off 

Switched Manual on on off 

Switched Auto- Answer off off on 



off 
off 
off 



EDX Requirements 



o 



If you want the adapter to respond to a remote IPL, strap bit of the multipoint 
address. 

You may need to install other jumpers, depending on the type of modem, as 
explained in the Binary Synchronous Features Description. 



Include EDX BSC support in the EDX supervisor. Use the BSCLINE statement to 
define each BSC line. Specify TYPE=PT if the line is leased, TYPE=SM if the 
line is switched manual, or TYPE=SA if the hne is switched auto-answer. 
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Station Definitions 



Define stations to represent: ^""\ 

• ThelOCP. Name=$.IO0A10, type=user. 

• The local end of each BSC line. Type=line, subtype=CPU. 

• The remote end of each BSC line. Type=line, subtype=CPU. 

• Each remote station to which local stations will send messages. 

Link each remote Une station to its corresponding local line station. Link the other 
remote stations as required for the communication you want. Be sure that each 
node has a unique node assignment and that the network address of each remote 
station is the same as the network address of the corresponding real station in the 
remote node. 



lOCP Operation Overview 



Restrictions 



The lOCP consists of one main task and a subtask for each started line station. 
The main task processes commands to stop or halt the lOCP and commands to 
start, stop, or halt line stations. Each line task processes data read from the line 
and messages that the message dispatcher has placed on the line station's queue. 

Except for the sending of an IPL bootstrap, exchange of messages does not begin 
until both lOCPs (one in each Series/ 1) are started and have established 
communication with each other. Thereafter, they operate in full conversational 
mode, writing and reading messages. 

When a message is placed on the line station's queue, the lOCP writes the entire /f"\ 

message (header and data) directly from the message buffer pool. The lOCP \_# 

writes it as transparent data, replacing the first 2 bytes of the message header with 
DLE/STX (X'1002'). When the line station's queue is empty, the lOCP writes 
just DLE/STX to maintain synchronization with the other lOCP. 

When the lOCP reads a message (not just DLE/STX) from the BSC line, it 
obtains a work area from the message buffer pool, moves the message to the work 
area, and sends it to the message dispatcher. The message dispatcher dispatches 
the message according to the destination information in the message header. 



The lOCP must run in the same partition as the Communications Facility control 
program ($.CFS or $.CFD). 

You can have only one active BSC point-to-point connection. Local 
Communications Controller connection, or X.25 connection through circuit 
stations with usage CF between two Series/ Is. 
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Point-to-Point lOCP, $.IO0A20 

The point-to-point lOCP manages communication between a Series/ 1 and the 
following IBM 2770 and 3 741 -like point-to-point devices: 

6640 Ink Jet Printer 

6670 Information Distributor 

Office System/ 6 Information Processor 

Displaywriter 

5520 Administrative System 

5280 Distributed Data System 

System/23 Datamaster 

Another Series/ 1 

The connection can be a leased or switched binary synchronous communications 
(BSC) line, operating in point-to-point mode. The lOCP can manage multiple 
connections to the same or different devices. 

You can use the lOCP in these ways: 

• To exchange data with one of the devices listed above. 

• To send documents from one device, such as a Displaywriter, to another 
device, such as a 6640 printer, through the Series/ 1. Connect each device to 
the Series/ 1 with a point-to-point BSC line and link the line stations to each 
other. 

• To send documents from multiple devices to a single destination device through 
the Series/ 1. You must provide an application program to prevent documents 
from being interspersed at the destination. 



Hardware Requirements 



Use of this lOCP requires a Series/ 1 BSC adapter (feature number 2074, 2075, or 
2093/2094), or a multifunction attachment (feature number 1310). 

Strap the BSC adapter (jumpers on or off) as follows, according to the type of 
connection: 

DTR No Ring Switched Line Multipoint 

Inhibit (MP address bit 7) Tributary 

off 
off 
off 

You may need to install other jumpers, depending on the type of modem, as 
explained in the Binary Synchronous Features Description. 



Leased Line 


on 


on 


off 


Switched Manual 


on 


on 


off 


Switched Auto- Answer 


off 


off 


on 
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EDX Requirements 



Include EDX BSC support in the EDX supervisor. Use the BSCLINE statement to 
define each BSC line. Specify TYPE=PT if the line is leased, TYPE=SM if the 
line is switched manual, or TYPE=SA if the line is switched auto-answer. 



w\ 



Station Definitions 



Define stations to represent: 

• ThelOCP. Name=$.IO0A20, type=user. 

• Each BSC line. Type=line, subtype=PTPT. 

Link each line station to the station that is to receive the data sent by the remote 
device. 



lOCP Operation Overview 



The point-to-point lOCP consists of one main task and a subtask for each started 
line station. The main task processes commands to stop or halt the lOCP and 
commands to start, stop, or halt line stations. Each line task processes data read 
from the line and messages sent to its line station's queue. 

The lOCP retrieves a message from a line station's queue and writes it to the BSC 
line with a write conversational instruction. If the lOCP receives text in response, 
it sends the data as a Communications Facility message, specifying the line station 
as the origin. If the lOCP has a direct link vector, it specifies that station as the 
destination; otherwise, it specifies a null destination. 

After sending all output messages, the lOCP checks the line for input. If it receives 
data, it processes the data as already described. It continues with alternating 
output and input operations until the line station is stopped or halted. 






Input Operations 



Basic Mode Input 



Record Mode Input 



The lOCP handles input data according to whether the line station is in basic mode 
or record mode and whether the data is transparent or not. 



If the line station is in basic mode, the lOCP sends the data without modification to 
its destination. 



If the line station is in record mode and the data is transparent (it begins with 
DLE/STX, X'1002'), the lOCP sends the data without modification to its 
destination. The lOCP also issues a warning log message to report that it received 
transparent data for a station in record mode. 

If the data is not transparent, the lOCP removes the first character (STX) and the 
last character (ETB or ETX) from the data before sending it to its destination. 
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Output Operations 



Basic Mode Output 



Record Mode Output 






Restrictions 



BSSEai 



The lOCP handles output data according to whether it is basic or record mode data 
and whether the line station is in transparent mode or not. 



The data is basic mode data if it begins with DLE/STX (X'1002') or STX. The 
lOCP handles multiple-block or single-block basic mode data. 

In multiple-block data, each block except the last one ends with ETB (X'26'). 
After sending the first block, the lOCP retrieves the next message from the line 
station's queue and sends it. (If the queue is empty, it waits until a message 
arrives.) It continues this process until it has sent the last block. If the last block 
doesn't end with ETX (X'03'), the lOCP appends an ETX before sending it. 

Single-block data is data that doesn't end with an ETB. If the last byte isn't an 
ETX, the lOCP appends an ETX before sending the data. 



If the data doesn't begin with DLE or STX, the lOCP appends BSC control 
information before sending it. If the Une station is in transparent mode (XON), the 
lOCP appends DLE/STX to the beginning of the message. If the line station is 
not in transparent mode (XOFF), the lOCP appends STX to the beginning of the 
message and ETX to the end of the message. 



You can use the point-to-point lOCP for communication between Series/ Is, but it 
is not as efficient as the Series/ 1-to-Series/l lOCP ($.IO0A10). 

If you use this lOCP for communication between Series/ Is with the program 
dispatcher, you must set record mode and transparency on for the line station in 
each cell. 

If you transmit large amounts of data with this lOCP, you should assign a disk 
queue to the line station so as to avoid flooding the message buffer pool. 
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TNL SN23-8600 (27 March 1987) to SL23-0104-2 

3101 lOCP, $.IO06F0 

I The 3101 lOCP allows you to use 3101 tenninals (models 12, 13, 22, and 23), 

I 3161, 3163 or 3164 tenninals in 3101 emulation mode, and IBM PCs running in 

3101 emulation mode as if they were 3277 model 2 terminals. The lOCP, 
$.IO06F0, manages communication with 3101 terminals connected to the Series/ 1 
by a feature programmable communications adapter, a multifunction attachment, 
or a 4950/5170-495 terminal/host adapter. 

You can use the lOCP in these ways: 

• For communication between 3101 terminals and host programs to which the 
Series/ 1 appears to be a 3270 system. See example 2 in the chapter "Sample 
Configurations** on page 269. 

• For communication between 3101 terminals and Series/ 1 programs. See 
example 5 in the chapter "Sample Configurations" on page 269. 

Hardware Requirements 

Use of this lOCP requires one of these attachment features: 

• Feature programmable communications adapter (feature number 2095/2096 
or feature number 2095/RPQ D02350). Up to eight 3101s can be attached 
locally or remotely with feature number 2095/2096. Up to eight 3101s can be 
attached locally with an RS422A electrical interface using feature number 
2095/RPQ D02350. When any of the terminals are being used as 
Communications Facility terminals, the one at subaddress must be active; the 
station that represents it must be started first and stopped last. (Subaddress 

' is the device address that is a multiple of 8.) 

• Multifunction attachment (feature number 1310). Up to four 3101s can be 
attached. Any of the four can be attached locally wiUi an RS422A electrical 
interface; this interface supports only models 13 and 23. Alternatively, the 
3101 at the base address can be attached locally or remotely with an RS232C 
electrical interface; this interface supports all models. 

• A terminal/host adapter is required for the 4950 or the 5 170-495. On the 
4950, up to four terminals can be attached locally to the terminal/host adapter 
using an RS422A electrical interface. One terminal can be attached locally or 
remotely to the Personal Computer Asynchronous Communications Adapter 
(feature number 1502074) using an RS232C electrical interface. 

On the 5170-495, up to four terminals can be attached locally to the 
terminal/host adapter using an RS422A electrical interface. Up to two 
terminals can be attached locally or remotely to the terminal/host adapter 
using an RS232C electrical interface. 

You must set the 3101 setup switches according to the type of attachment and 
whether you're using the 3101 as an EDX terminal or a (Iloiomunications Facility 
terminal. Descriptions of the setup switches are in the 5 i 07 Display Terminal 
Description manual. Figure 21 on page 122 shows required and recommended 
switch settings, assuming a bit rate of 9600. The 32 switches are shown in groups 
of 8; each nimiber (1-8) represents a switch. A letter above the number of the 
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Feature Programmable Communications Adapter or Multifunction Attachment 
Communications Facility Terminal 



FI I I IIIX S SS S 

1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 
IIM XI XIII II I XIIXX SS SS 

Feature Programmable Communications Adapter or Multifunction Attachment 
EDX Terminal 



BRFI I X XXIXX S SS S 

1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 
CM XI XIII II I IIXX SS SS 



4950/5170-495 Terminal/Host Adapter 
Communications Facility Terminal 



II IIIIX ssss 

1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 
III XI XIII II I XIIXX SS SS 



4950/5170-495 Terminal/Host Adapter 
EDX Temimal 



BRI I X XXIXX S SS S 

1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 
CI XI XIII II I IIXX SS SS 

B SB Device is defined to EDX as a block mode device. 

C K Device is defined to EDX as a character mode device. 

F « Feature programmable communications adapter or multifunction 

attachment with LMODE of PTTOPT, SWITCHED, or LOCAL. 
I B Must be in the position shown. 
M e Multifunction attachment with LMODE of RS422. 
R SB Must be in the position shown for a character mode device; 

can be in either position for a block mode device. 
S » Depends on line speed used. 9600 bps is shown. 
X « May be in either position, but X is recommended. 

Figure 21. 3101 Setup Switches 



corresponding switch indicates that the switch is up, and a letter below the number 
indicates that the switch is down. 

Use Figure 22 on page 123 as a guide to setup a 3161, 3163, or 3164 device in 
3101 emulation mode. 
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Machine Mode 
Operating Mode 



IBM 3101 
ECHO 



Interface 

Line Control 

Line Speed (bps) 

Parity 

Turnaround Character 

Stop Bit 

Word Length (bits) 

Response Delay (ms) 

Break Signal (ms) 



Main Port 

RS-232C Q 

PRTS 

9600 U 

SPACE 

CR 

2 

7 

100 

500 



Auxiliary Port 



9600 



e 



SPACE 
2 



Terminal ID: 



(Up to 20 alphanumeric characters are allowed.) 



Figure 22. 3161/3163/3164 Device Configunitkm Menu 

where: 



Specify ECHO for use as a Communications Facility terminal. Specify 
CHAR or BLOCK for use as an EDX terminal as defined in your EDX 
terminal definitions. 



Specify RS-232C for a feature programmable communications adapter or a 
multifunction attachment with LMODE of PTTOPT, SWITCHED, or 
LOCAL. Specify RS-422A for a 4950 or a 5170-495 Series/1 system unit, 
Terminal/Host Adapter or a multifunction attachment with LMODE of 
RS422. 



Depends on line speed. 9600 bits per second is shown. 



D 



Specified for IBM 3161 only. 



Figure 23 shows the recommended configuration for the selection line for a 
3161/3163/3164 terminal running as a Communications Facility device. 



SCROLL=OFF RETURN=CR LINE WRAP=ON AUTO LF=OFF SEND=LINE NULL SUPP=OFF 



Figure 23. 3161/3163/3164 Selection Line 
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You must strap the feature programmable communications adapter to match the 
3101 configuration, as explained in the EDX Installation and System Generation 
Guide. 

You must jumper the interface as either an EIA (RS-232C) interface or a TTY 
(20mA current loop) interface. The other jumpers that you may need to modify 
are the request to send (RTS) jumper, the data terminal ready (DTR) jumper, and 
the data carrier detect (DCD) jumper. You must also jumper the line speed range 
appropriately. 

No strapping is required for the multifunction attachment or the terminal/host 
adapter on the 4950 and S 170-495. The EDX supervisor definition statements 
ADAPTER and TERMINAL or CFTERM define the 3101 configuration. 

If you are using a remote connection, refer to your modem guide for the possible 
switch settings on your particular modem. Most modems provide switch settings 
for data terminal ready (DTR), auto-answer (AA), and carrier detect (CD). 
Depending on the modem you use, you may need to modify the carrier detect 
switch setting on the Series/ 1 modem to enable the remote 3101 to make a 
connection. See Appendix A, "Configuring and Connecting 3101 Display 
Terminals" on page 452.1 for information on how to connect a 3101 to $.IO06F0. 



EDX Requirements 



3101s on a terminal/host adapter or a feature programmable communications 
adapter require no EDX support if you plan to use them only as Communications 
Facility terminals. If you're also going to use them as EDX terminals or as 
Communications Facility work session controller terminals, include EDX terminal 
support in the EDX supervisor, and use the TERMINAL statement to define each 
3101. 

For 3101s on a multifunction attachment, include EDX multifunction attachment 
support in the EDX supervisor, and use the ADAPTER statement to define the 
attachment. If you plan to use the terminals only as Commimications Facility 
terminals, use the Communications Facility CFTERM instruction to define each 
3 101 ; no EDX support is required. If you're also going to use them as EDX 
terminals or as Communications Facility work session controller terminals, include 
EDX terminal support in the EDX supervisor, and use the TERMINAL statement 
to define each 3101. 

You must include EDX unmapped storage support in the EDX supervisor. 






Station Definitions 



Define stations to represent: 

• The lOCP. Name«$.IO06F0, type«user. 

• Each 3101. Type=device, subtype«3 lOlF. 

When you define a 3101 device station to the Communications Facility, specify 
auto-answer OFF if you have a local connection, or specify auto-answer ON if you 
have a remote connection. Specify a bit rate to match the attachment card line 
speed, the modems (if any), and the bit rate setting on the 3101. 
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If you have defined the 3101s to EDX, use station names that are different from 
the EDX terminal names. 

Link each device station with a station that represents an emulated terminal or an 
application program. 



Supporting Multiple 3101s 



The lOCP can manage multiple 3101s concurrently. Although the 3101 operates 
in intemipt-per-character mode, the instruction path length through the interrupt 
handling code is generally short enough so that there is minimal interference with 
the operation of other 3101s and with any batch work. The exact number of 
devices that can be supported depends on processor speed, 3101 line speed, 
available processor storage, and other tasks being executed concurrently. 

The amount of available mapped and unmapped storage and the size of $.ICX)6F0's 
dynamic storage area are the limiting factors in determining the number of 3101s 
that can be managed by $.IO06F0. See "Planning Storage Requirements*' on 
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page 213 for a discussion on determining the amount of processor storage and 
dynamic storage required to support multiple 3101s. 



lOCP Operation Overview 






The 3101 lOCP consists of a main task and a subtask for each started device 
station. The main task processes commands to stop or halt the lOCP and 
commands to start, stop, or halt device stations. Each device subtask processes 
data received from a 3101 and messages sent to the station that represents that 
3101. 

The lOCP makes the 3101 appear as a 3277 to the operator and to the programs 
that communicate with the terminal. Although the 3101 is an unbuffered device, 
the lOCP makes it appear as a buffered device. Device buffering is done in 
Series/ 1 processor storage, using the unmapped storage management facilities of 
EDX. 

Figure 24 summarizes the 3270 functions and the level of support that the 3101 
lOCP provides. For more information about these functions, see the 32 71 Guide. 

Supported 
Function Yes No 

Remote Command Codes 

Write (Fl) X 

Erase/ write (F5) X 

Erase/write alternate (7E) X 

Read buffer (F2) X 

Read modified (F6) X 

Copy (F7) X 

Erase all unprotected (6F) X 

Write Control Character 

Reset MDT X 

Keyboard restore X 

Sound alarm X 

Start printer X* 

Define printout format X 

Printer Control Orders X^ 

Buffer Control Orders 

Start field (SF) X 

Set buffer address (SBA) X 

Figure 24 (Part 1 of 2). 3270 Functions Supported on 3101 



^ The start printer bit causes the screen to be printed at the 3 102 printer attached to the 
3101. This applies only to a 3101 model 2n. 

5 Printer control orders display on a 3101 the same as they do on a 3277. 

Using the Supplied Input/ Output Control Programs 125 



tibliHiil 



Supported 



Function 



Card reader 



Selector pen 



Yes 



Insert cursor (IC) 


X 


Program tab (PT) 


X 


Repeat to address (RA) 


X 


Erase unprotected to address (EUA) 


X 


Attributes 

Protected/unprotected 


X 


Alpha/numeric 


X 


Automatic skip 


X 


High/normal intensity 


X6 


Non-display 


X 


Selector-pen detectable 




Modified data tag 


X 


Keyboard 




ENTER 


X 


PF1-PF12 


X 


PA1-PA3 


X 


CLEAR 


X 


ERASE EOF 


X 


ERASE INPUT 


X 


DEL 


X 


RESET 


X 


FM (field mark) 


X 


DUP 


X 


INS MODE 


X 


TEST REQ 




CURSR SEL 




Cursor movement 


X 


Lowercase alpha 


X 



No 



ii 



X 
X 



X 
X 



Input from Terminals 



Figure 24 (Part 2 of 2). 3270 Functions Supported on 3101 



The lOCP reads input from a 3101 and holds it in a device buffer in processor 
storage. When the operator presses a program attention key (see the section "3101 
Keyboard" on page 127), the lOCP formats the input data as a 3270/BSC data 
stream. The data stream is the same as if it had originated from a remote 3277 
model 2 terminal in response to a 3270 read modified command. 



6 A high-intensity field displays at normal intensity. 
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The lOCP sends the data as a Communications Facility message, specifying the 
device station as the origin. If the lOCP has a direct link vector, it specifies that 
station as the destination; otherwise, it specifies a null destination. 



Figure 25 on page 128 shows the 3101 keyboard as supported by the 3101 lOCP. 
The corresponding key numbers for the 3161/3163/3164 keyboards are shown 
along with the 3101 key numbers. A description of the supported functions 
follows. Pressing keys that have a legend of "Ignored" causes the alarm to beep; 
nothing is entered into the device buffer. Pressing keys that have a legend of 
"Local Function" causes the indicated function, but no data enters the system. 



3161/3163/3164 Keyboard 



Figure 26 on page 129 shows the 3161/3163/3164 keyboard as supported by the 
3101 lOCP. The corresponding key numbers for the 3101 keyboard are shown 
along with the 3161/3163/3164 key numbers. 
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Mrr} 



Legend: 



an 



Ignored 



Q 



Local function \. 



Enter Exit 

insert character insert character 

mode mode 

Press ESC before pressing this key to activate the 
function shown on the front of the key. 

Press and hold ALT to activate the function 
shown on the front of the key. 



Figure 25. 3101 Keyboard 
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Legend: 

BB 
SB 



Ignored 



Local function 



S 




Enter Exit 

insert character insert character 

mode mode 

Press ESC before pressing this key to activate the 
function shown on the front of the key. 

Press and hold the Ctrl to activate the function 
shown on the front of this key. 



Figure 26. 3 1 61 /3 1 63/3 1 64 Keyboard 
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3101/3161 Key Functions 

The following keys correspond to the keys on the 3277 display station keyboard 
(see the 3271 Guide): 

• Cursor movement keys 

The following keys move the cursor. They don't affect MDT bits. 

- Cursor up, down, left, right (#58/88, 59/98, 79/97, 80/99) 

- Tab key (#24/38) 

- Backtab key (#23/54) 

- New line key (#78/71) 

- Home key (#37/32) 

. ERASE EOF key (#2/54) 

When the cursor is located within an unprotected field, the ERASE EOF key 
clears character locations from the cursor location to the end of the field to 
nulls. It also sets the MDT bit to 1 . The cursor does not move. When the 
cursor is located at an attribute character or within a protected field, the 
ERASE EOF key disables the keyboard. No character locations are cleared; 
the cursor does not move; and the MDT bit is not set. 

. ERASE INPUT key (#2/33) 

This key clears all unprotected character locations to nulls, resets MDT bits to 

in unprotected fields, and repositions the cursor to the first unprotected 

character location on the screen. 4 \ 

. INS (Insert) MODE 

Two keys on a 3101 keyboard provide this function: 

- ENTER INSERT CHARACTER MODE key (#53/67) 

This key puts the keyboard controls in insert mode. When the terminal 
operator presses this key, the cursor blinks and the alarm beeps. When the 
cursor is located within an unprotected field that contains null characters at 
or beyond the cursor location, pressing an alphanumeric key causes a 
character to be entered at the cursor location and sets the MDT bit to 1 . 
The character that was at the cursor location and all remaining non-null 
characters in the field are shifted right one location. After all null 
characters at or beyond the cursor location in the field are overwritten (or 
if there were no null characters), pressing an alphanumeric key causes the 
alarm to beep. 

- EXIT INSERT CHARACTER MODE key (#54/68) 

This key returns the keyboard controls to normal mode. When the 
terminal operator presses this key, the cursor blinks and the alarm beeps. 



o 
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. DEL CHAR key (#17/32) 



^j! When the cursor is located within an unprotected field, the DEL key deletes 

the character from the location occupied by the cursor and sets the MDT bit to 
1. The cursor does not move. 

When the cursor is located at an attribute character or is within a protected 
field, the DEL key disables the keyboard. No character locations are cleared; 
the cursor does not move; and the MDT bit is not set. 

• RESET Keyboard 

Two keys on a 3101 keyboard provide this function: 

~ BREAK key (#18/16) 

This key resets a disabled keyboard resulting from a condition that the 
lOCP detected. 'SYSTEM COMMAND' on line 25 of the screen indicates 
these conditions. 

- RESET key (#84/93) 

This key resets a disabled keyboard resulting from a condition that the 
hardware detected. Messages such as 'LOCK-SYSTEM COMMAND' 
and 'LOCK-REKEY' on line 25 of the screen indicate these conditions. 

. FM (field mark) key (#35 or 43/15) 

^ This key enters a unique character code into the device buffer and sets the 

MDT bit to 1. The field mark character is X'lE'; it displays as a semicolon (;). 

The field mark function is provided by two keys in case one of the keys is used 
for another purpose, such as a national character. 

. DUP key (#35 or 43/15) 

This key enters a unique character code into the device buffer, performs a tab 
key operation, and sets the MDT bit to 1. The DUP character is X'lC; it 
• displays as an asterisk (*). 

The DUP function is provided by two keys with $.IO06F0 in case one of the 
keys is used for another purpose, such as a national character. 

• Program attention keys 

The following keys terminate an input operation and disable the keyboard. An 
attention identification (AID) character that identifies the key is generated, but 
the MDT bit is not affected. The AID is included in the 3270 data stream that 
results from the input operation. 

- CLEAR key (#23/33) 

The CLEAR key clears the device buffer to nulls, positions the cursor at 
f% location 0, and resets all MDT bits. 

- ENTER key (#16/30) 
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- Program access keys 1, 2, 3 (#60/2, 61/3, 62/4) 

- Program function keys 1-12 (#4/18, 5/19, 6/20, 7/21, 8/22, 9/23, 
10/24, 11/25, 12/26, 13/27, 14/28, 15/29) 

3101/3161/3163/3164 Key Functions 

The following keys provide functions that are not available on a 3277 keyboard. 

• Program access key 6 (#42/7) 

This key copies the contents of the screen to the EDX device defined as the 
3101 station's hardcopy device. If the station that represents the 3101 is in 
non-display mode, lowercase characters are translated to uppercase for 
printing. If the station is in text mode, lowercase characters are not translated. 

• STOP key (#19/8) 

This key stops the 3101 as a Communications Facility terminal. If the 3101 is 
defined to EDX, it becomes an EDX-only terminal; otherwise it is unavailable. 
You should use this key to disconnect a 3101 terminal connected over a 
switched line. 

. REFSH (refresh) key (#20/9) 

This key displays the contents of the device buffer. 

3101/3277 Keyboard Differences 

Because of the physical differences between 3277 and 3101/3161/3163/3164 
keyboards, two of the characters of the 3277 keyboard use different keys on the 
3101/3161/3163/3164 keyboards. These characters are: 

3277 3101/3161/3163/3164 

A (key #9/23) 

\ (key #36/51) 

The character shown on the face of the key displays, but the lOCP enters the 
equivalent 3277 character into the device buffer. 

Uppercase/Lowercase Support 

Two character sets are supported for the 3101: uppercase (mono) and 
uppercase/lowercase (dual). The setting of the ei^th setup switch (the 
mono/dual switch) controls character set; up is dual, and down is mono. 

When the keyboard is set to dual mode, key #3, key #57, and key #36 (upshift) are 
active. Using these keys in mono mode causes XOCK-MODE/SETUP CHECK* 
to display on line 25 of the screen. Press the RESET key (#84) to reset the 
keyboard. 
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Since the 3101 is unbuffered, overrun situations can occur. An overrun is most 
likely to occur on 9600 bps lines when several operators simultaneously press 
typamatic cursor movement keys, causing two characters of data to be sent down 
the line for each keystroke. If an overrun does occur, the lOCP sends back an 
audible beep to the overrun device, and ignores the character in error. The 
keyboard may lock if characters are still being entered when the overrun is 
detected, causing 'LOCK-SYSTEM COMMAND' to display on line 25 of the 
screen. Press the RESET key (#84) to reset the keyboard. If 'SYSTEM 
COMMAND' persists after a reset, then press the BREAK key (#18). You can 
then rekey the missed character, or, in the case of cursor movement, continue to 
hold down the typamatic key. 



Chaining Keyboard Functions 






You can change the functions of 3101 keys. To do so, you need to change the 
input interrupt handler module (S$IO06F3) and, in some cases, the main module of 
the lOCP (S$IO06F0). 

The input interrupt handler processes each input character according to the 
definition in table BRINDEX in module S$IO06FT. For $.IO06F0, the BRINDEX 
table is in module S$IO06FT. This table defines an index to branch table 
BRTABLE for the 128 values of the ASCII character set. There are four general 
groups of characters: numeric characters, alphabetic and other graphic characters, 
ignored control characters, and supported control characters. The input interrupt 
handler processes some of the supported control characters, and the main module 
processes others. The main module refers to characters by names equated to hex 
values. If you define different characters for functions processed in the main 
module, you'll need to change the EQU statements, which are located just before 
the executable code. 

These are the supported control functions: 

ASCII Hex Function 3101 Key 



00 


Reset keyboard 


#18 


07 


Alarm 




08 


Enter 


#16 


09 


Tab 


#24 


OB 


Enter insert mode 


ALT/#53 


OC 


Exit insert mode 


ALT/#54 


OD 


New line 


#78 


IB 


Escape 


#22 


5B 


Field mark 


#35 (downshift) 


5D 


Dup 


#35 (upshift) 


7F 


Delete 


#17 



The main module processes the reset keyboard and enter functions. The input 
interrupt handler processes the other functions. 
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When the input interrupt handler receives an escape character, it proceeds 
according to the next character it receives. The main module processes these 
escape sequences: 



ASCII Hex Function 



3101 Key 



1B31-1B39 


PF1-PF9 


ESC,#4-ESC,#12 


1B30 


PFIO 


ESC, #13 


1B2D 


FPU 


ESC, #14 


1B3D 


PF12 


ESC, #15 


1B4B 


Erase input 


ALT/#2 


1B4C 


Clear 


ALT/#23 


1B61 


PAl 


ALT/#60 


1B62 


PA2 


ALT/#61 


1B63 


PA3 


ALT/#62 


1B66 


Hardcopy 


ALT/#42 


1B67 


Stop 


ALT/#19 


1B68 


Refresh 


ALT/#20 



Note that PF1-PF9 must be contiguous values. 

The input interrupt handler processes these escape sequences at label ESCOK: 



ASCII Hex Function 



3101 Key 



1B41 


Cursor up 


#58 


1B42 


Cursor down 


#59 


1B43 


Cursor right 


#80 


1B44 


Cursor left 


#79 


1B48 


Home 


ALT/#37 


1B49 


Erase EOF 


#2 


1B4A 


Back tab 


#23 


1B55 


Dup 


ALT/#43 


1B56 


Field mark 


#43 






Any other escape sequence causes the alarm to beep. 



The lOCP receives messages sent to device stations and interprets them as 
3270/BSC data streams. It processes messages as a 3271 control unit does, 
according to the 3270 command and orders in the data stream. It supports the 
same commands as a 3271, except for the copy command. It discards any message 
that contains a copy command. 

If a message doesn't begin v/ith STX (X'02'), the lOCP processes the message as a 
write command with keyboard restore specified in the write control character. 
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A 3101 operating in character mode doesn't provide high-intensity display. You 
might want to highUght high-intensity fields by displaying a special character 
instead of a blank at the attribute character location. To do so, you'll need to 
change the EBCDIC-to- ASCII conversion table in the output interrupt handler 
module. For $.IO06F0, the table is EBCD2ASC in module S$IO06FT. 

By the time an attribute character is ready for display, bits 0, 1 , and 6 are zero. A 
value of X'lO' for bits 4 and 5 defines high intensity. Therefore, the attribute 
character for a high-intensity field has a hex value of 08, 09, 18, 19, 28, 29, 38, or 
39. To display these attributes as other than blanks, define the ASCII value of the 
character you want displayed in those positions of the table. 

For example, to change EBCD2ASC to display a caret ( A ): 

ORG EBCD2ASC+X ' 08 ' 

DC X'5E5E' 

ORG EBCD2ASC+X' 18' 

DC X'5E5E' 

ORG EBCD2ASC+X'28' 

DC X'5E5E' 

ORG EBCD2ASC+X'38' 

DC X'5E5E' 



Changing ASCII/EBCDIC Translation Tables 






You can change the tables that the lOCP uses for translating terminal input from 
ASCII to EBCDIC and terminal output from EBCDIC to ASCII. You may want 
to do this, for example, to support your national character set. 

There are three tables: 

. The EBCDIC to ASCII translation table 

• The ASCII to EBCDIC translation table 

• A branch index table. 

The branch index table defines each ASCII value as an alphabetic character, a 
numeric character, a supported control character, or an ignored value. The table 
names and the modules in which they reside are: 





$.IO06F0 




Table 


Name 


Module 


EBCDIC to ASCII 


EBCD2ASC 


S$IO06Fr 


ASCII to EBCDIC 


ASC2EBCD 


S$IO06Fr 


Branch Index 


BRINDEX 


S$IO06FT 






For example, the codes for the U.S. character double quote (") are EBCDIC X'7F' 
and ASCII X'22'. Suppose that EBCDIC X'7F' is instead a national character 
whose ASCII code is X'5C'. To support that character, change the tables as 
follows: 

1 . Change the ECBDIC to ASCII table at offset X'7F' t9 the ASCII code, X'5C'. 

2. Change the ASCII to EBCDIC table at offset X'5C' to the EBCDIC code, 

X'7F'. 
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3. Change the branch index table at offset X'5G' to X'24' to define the national 
character as a numeric character or to*X'28' to define it as an alphabetic 
character. 



^~\ 



There are special considerations if the ASCII code for a national character is X'5B' 
or X'5D', The lOCP associates these values with 3101 key #35 and interprets 
them as a field mark and a dup key respectively. When you change the tables to 
support those values as national characters, you lose the field mark and dup 
functions. 

$.IO06F0 includes definitions that allow you to retain the field mark and dup 
functions. Field FMEXTRA contains the ASCII code for field mark and is 
associated with 3101 key #43. Field DUPEXTRA contains the ASCII code for 
dup and is associated with 3101 key ALT/#43. Both of these fields are in module 
S$IO06FT. 

To support ASCII X'5B' and X'5D' as national characters, change the tables as 
described above. Then make these changes to module S$IO06FT to redefine the 
field mark and dup functions: 

1 . Change field FMEXTRA to any ignored ASCII value, such as X'0 1 '. (See 
table BRINDEX to determine which values are ignored.) 

2. Change field DUPEXTRA to any ignored ASCII value, such as X'02'. 



3. Change table ASC2EBCD at offset X'Ol' to TB' (the internal EBCDIC code 
for the field mark function). 

4. Change table ASC2EBCD at offset X*02' to 'FA' (the internal EBCDIC code 
for the dup function). 






Restrictions 



Do not cancel $.IO06F0 using the EDX $C command. If you do, the unmapped 
and mapped storage obtained by the lOCP is not returned to the system. Use CP 
H $.IO06F0 to terminate the lOCP user station and its device stations. 



136 Communications Facility Design and Installation Guide 



tflM'I#l 



4978/4980 Data Stream lOCP, $.100670 



The 4978/4980 data stream lOCP allows you to use 4978 and 4980 terminals as if 
they were 3277 model 2 terminals. $.100678 is now called $.100670. 

For 4978s, it uses an RPQ control store called the 4978 Data Stream Control Store 
(D02428), which provides 3270 functions. 

For 4980 terminals, the lOCP uses a control store, image store, and microcode 
random access memory (RAM), which provide the 3270 functions. 

You can use the lOCP in these ways: 

• For communication between 4978/4980 terminals and host programs to which 
the Series/ 1 appears to be a 3270 system. See example 1 in the chapter 
"Sample Configurations" on page 269. 

• For communication between 4978/4980 terminals and Series/ 1 programs. 



Hardware Requirements 



EDX Requirements 



For 4978s, this lOCP requires the 4978 keyboard RPQ D02056. 






Include EDX terminal support modules in the EDX supervisor, and use the 
TERMINAL statement to define each terminal. 

For 4980s, include EDX 4980 power-on random access memory support in the 
EDX supervisor. 



Station Definitions 



Define stations to represent: 

. ThelOCP. Name= $.100670, type=user. 

• Each 4978 or 4980 terminal. Type = device, subtype =497 8. 

When you define the device stations, use station names that are different from the 
EDX terminal names. Link each device station with a station that represents an 
emulated terminal or an application program. 



Data Set Requirements 



For 4978s, this lOCP requires data sets $.RPOCS0 and $.RPQISO (the data stream 
RPQ control and image stores), which are distributed with the Communications 
Facility, and the standard 4978 control and image stores, $4978CS0 and $4978IS0, 
which are distributed with EDX. 



For 4980s, in addition to the data sets required for 4978s, this lOCP requires data 
sets $4980CSA, $4980ISA, and $4980R0A (control store, image store, and 
microcode random access memory), which are distributed with the 
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Communications Facility; and $4980CS0, $4980180, and $4980R01, which are 
distributed with EDX. 



lOCP Operation Overview 



The 4978/4980 data stream lOCP consists of a main task and a subtask for each 
started device station. The main task processes commands to stop or halt the lOCP 
and commands to start, stop, or halt device stations. Each device subtask processes 
data received from a 4978/4980 and messages sent to the station that represents it. 

When a device station is started, the lOCP enqueues on the terminal and loads the 
data stream RPQ control and image stores for a 4978 or the control store, image 
store, and microcode random access memory for a 4980. The lOCP and the data 
stream support make the 4978 or 4980 look like a 3277 to the operator and to the 
programs that communicate with the terminal. 

When a device station is stopped, the lOCP loads the standard control and image 
store for a 4978 or the standard control store, image store, and microcode random 
access memory for a 4980. The lOCP then dequeues the terminal. 

You can enter and display both uppercase and lowercase characters. For a 4978, 
the relationship between the keyboard shift and the uppercase and lowercase 
alphabets is defined by modes UL (upper/lower), LU (lower/upper), and UU 
(upper/upper). When the 4978 station is in UL mode, downshift produces 
uppercase letters and upshift produces lowercase letters. When the station is in LU 
mode, downshift produces lowercase letters and upshift produces uppercase letters. 
When the station is in UU mode, either shift produces uppercase letters. 

Input to numeric fields is validated when you enter it at the keyboard, as for a 
3277. You can use 4978 or 4980 keys to enable and disable numeric field 
validation. See the appropriate keyboard description for the location of these keys. 

Field intensity (high, normal, or non-display) is as specified in the field attribute 
character. 

Figure 27 on page 139 summarizes the 3270 functions and level of support that 
the 4978/4980 data stream lOCP provides. For information about these 
functions, see the 3271 Guide. 
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Supported 






Function 

Remote Command Codes 
Write (Fl) 
Erase/write (F5) 
Erase/write alternate (7E) 
Read buffer (F2) 
Read modified (F6) 
Copy (F7) 
Erase all unprotected (6F) 



Yes 



X 
X 
X 
X 
X 

X 



No 



Write Control Character 




Reset MDT 


X 


Keyboard restore 


X 


Sound alarm 


X 


Start printer 




Define printout format 




Printer Control Orders 


X7 


Buffer Control Orders 




Start field (SF) 


X 


Set buffer address (SBA) 


X 


Insert cursor (IC) 


X 


Program tab (PT) 


X 


Repeat to address (RA) 


X 


Erase unprotected to address (EUA) 


X 


Attributes 




Protected/unprotected 


X 


Alpha/numeric 


X 


Automatic skip 


X8 


High/normal intensity 


X 


Non-display 


X 


Selector-pen detectable 




Modified data tag 


X 


Keyboard 




ENTER 


X 


PF1-PF12 


X 


PA1-PA3 


X 


CLEAR 


X 


ERASE EOF 


X 


ERASE INPUT 


X 


DEL 


X 


RESET 


X 


FM (field mark) 


X 


DUP 


X 


INS MODE 


X 


Figure 27 (Part 1 of 2). 3270 Functions Supported on ' 



X 
X 



"^ Printer control orders display on a 4979/4980 the same as they do on a 3277. 
8 The 4978/4980 always skips over protected data during keyboard entry. 
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Input from Terminals 



4978 Keyboard 



Supported 

Function Yes No 

TEST REQ X 

CURSR SEL X 

Cursor movement X 

Lowercase alpha X 

Card reader X 

Selector pen X 

Figure 27 (Part 2 of 2). 3270 Functions Supported on 4978/4980 — Data Stream Mode 



,^> 



Input from the terminal is a 3270/BSC data stream. The data stream is the same 
as if it had originated from a remote 3277 model 2 terminal in response to a 3270 
read modified command. The lOCP sends the data stream as a Communications 
Facility message, specifying the device station as the origin. If the lOCP has a 
direct link vector, it specifies that station as the destination; otherwise, it specifies a 
null destination. 



Figure 28 on page 141 shows the 4978 keyboard as supported by $.100670. ^ A 

Pressing keys that have a legend of "Local Function" causes the indicated function, \(|^ y 

but no data enters the system. 

4978/3277 Key Functions 

The following keys correspond to the keys on a 3277 display station keyboard (see 
the 527/ Guide)'. 

• Cursor movement keys 

The following keys move the cursor. They don't affect MDT bits. 

- Cursor down, up, left, right (#146, 147, 168, 169) 

- Tab key (#88 or 170) 

- Backtab key (#103 or 127) 

- New line key (#124) 

- Home key (#126) 

. ERASE EOF key (#83) 

When the cursor is located within an unprotected field, the ERASE EOF key 
clears character locations from the cursor location to the end of the field to 



o 
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Figure 28. 4978 Keyboard — Data Stream Mode 



nulls. It also sets the MDT bit to 1. The cursor does not move. When the 
cursor is located at an attribute character or within a protected field, the 
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ERASE EOF key disables the keyboard. No character locations are cleared; 
the cursor does not move; and the MDT bit is not set. 

ERASE INPUT key (#15) 

This key clears all unprotected character locations to nulls, resets MDT bits to 
in unprotected fields, and repositions the cursor to the first unprotected 
character location on the screen. 

INS (Insert) MODE 

Two keys on a 4978 keyboard provide this function: 

- INS MODE key (#104) 

This key puts the keyboard controls in insert mode. When the terminal 
operator presses this key, the cursor bhnks. When the cursor is located 
within an unprotected field that contains null characters at or beyond the 
cursor location, pressing an alphanumeric key causes a character to be 
entered at the cursor location and sets the MDT bit to 1. The character 
that was at the cursor location and all remaining non-null characters in the 
field are shifted right one location. After all null characters at or beyond 
the cursor location in the field are overwritten (or if there were no null 
characters), pressing an alphanumeric key causes the alarm to beep. 

- RESET key (#125) 

This key returns the keyboard controls to normal mode. When the 
terminal operator presses this key, the cursor blinks and the alarm beeps. 

DEL key (#105) 

When the cursor is located within an unprotected field, the DEL key deletes 
the character from the location occupied by the cursor and sets the MDT bit to 
1 . The cursor does not move. 

When the cursor is located at an attribute character or is within a protected 
field, the DEL key disables the keyboard. No character locations are cleared; 
the cursor does not move; and the MDT bit is not set. 

RESET KBD key (#37) 

This key resets a disabled keyboard. 

FM (field mark) key (#67) 

This key enters a unique character code into the device buffer and sets the 
MDT bit to 1. The field mark character is X'lE'; it displays as a semicolon (;). 

DUP key (#102) 

This key enters a unique character code into the device buffer, performs a tab 

key operation, and sets the MDT bit to 1. The DUP character is X'lC; it 

displays as *. g^^ 
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• Program attention keys 

The following keys terminate an input operation and disable the keyboard. An 
attention identification (AID) character that identifies the key is generated, but 
the MDT bit is not affected. The AID is included in the 3270 data stream that 
results from the input operation: 

- CLEAR key (#23) 

The CLEAR key clears the device buffer to nulls, positions the cursor at 
location 0, and resets all MDT bits. 

- ENTER key (#81 or 106) 

- Program access keys 1, 2, 3 (#3, 4, 6) 

- Program function keys 1-12 (#17, 19, 20, 22, 39, 41, 42, 44, 61, 63, 64, 
66) 

4978 Key Functions 

The following keys provide functions that are not available on a 3277 keyboard: 

. PA6 key (#10) 

This key copies the contents of the screen to the EDX hardcopy device. 

. STOP key (#12) 

This key stops the 4978 as a Communications Facility terminal, and releases it 
for use as an EDX terminal. 

. RESET NUMERIC EDIT key (#13) 

This key turns off the numeric edit feature for numeric fields. 
. SET NUMERIC EDIT key (#35) 

This key turns on the numeric edit feature for numeric fields. 



4980 Keyboard 






Figure 29 on page 144 shows the 4980 keyboard as supported by $.100670. 
Numbers 1 through 125 on the keys in the top part of the figure have no 
significance other than for reference numbers. When two numbers are shown on 
the keyboard, the number beneath the slash (/) is the interrupt function code. 

Pressing keys that have a legend of "Local Function" causes the indicated function, 
but no data enters the system. 
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Figure 29. 4980 Keyboard — Data Stream Mode 
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4980/3277 Key Functions 






The following keys correspond to the keys on a 3277 display station keyboard (see 
the 527/ Guide): 

• Cursor movement keys 

The following keys move the cursor. They don't affect MDT bits. 

- Cursor down, up, left, right (#123, 88, 109, 111) 

- Tab key (#51) 

- Backtab key (#64) 

- New line key (#87) 

- Home key (#110) 

. ERASE EOF key (#73) 

When the cursor is located within an unprotected field, the ERASE EOF key 
clears character locations from the cursor location to the end of the field to 
nulls. It also sets the MDT bit to 1 . The cursor does not move. When the 
cursor is located at an attribute character or within a protected field, the 
ERASE EOF key disables the keyboard. No character locations are cleared; 
the cursor does not move; and the MDT bit is not set. 

. ERASE INPUT key (#26) 

This key clears all unprotected character locations to nulls, resets MDT bits to 
in unprotected fields, and repositions the cursor to the first unprotected 
character location on the screen. 

. INS MODE key (#66) 

This key puts the keyboard controls in insert mode. When the cursor is located 
within an unprotected field that contains null characters at or beyond the 
cursor location, pressing an alphanumeric key causes a character to be entered 
at the cursor location and sets the MDT bit to 1 . The character that was at the 
cursor location and all remaining non-null characters in the field are shifted 
right one location. After all null characters at or beyond the cursor location in 
the field are overwritten (or if there were no null characters), pressing an 
alphanumeric key causes the alarm to beep. 

. DEL key (#67) 

When the cursor is located within an unprotected field, the DEL key deletes 
the character from the location occupied by the cursor and sets the MDT bit to 
1 . The cursor does not move. 

When the cursor is located at an attribute character or is within a protected 
field, the DEL key disables the keyboard. No character locations are cleared; 
the cursor does not move; and the MDT bit is not set. 

. RESET KBD key (#118) 

This key returns the terminal to normal mode. 

. FM (field mark) key (#44) 
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This key enters a unique character code into the device buffer and sets the 
MDT bit to 1, The field mark character is X'lE'; it displays as a ;. 

. DUP key (#43) \^ 

This key enters a unique character code into the device buffer, performs a tab 
key operation, and sets the MDT bit to 1. The DUP character is X'lC; it 
displays as *. 

• Program attention keys 

The following keys terminate an input operation and disable the keyboard. An 
attention identification (AID) character that identifies the key is generated, but 
the MDT bit is not affected. The AID is included in the 3270 data stream that 
results from the input operation. 

- CLEAR key (#26) 

The CLEAR key clears the device buffer to nulls, positions the cursor at 
location 0, and resets all MDT bits. 

- ENTER key (#122) 

— Program access keys 1, 2, 3 (#42, 43, 44) 

— Program function keys 1-12 (#1-12) 
4980 Key Functions 

The following keys provide functions that are not available on a 3277 keyboard: \..Jr 

• Local print key (#47) 

This key copies the contents of the screen to the EDX hardcopy device. 

. STOP key (#48) 

This key stops the 4980 as a Communications Facility terminal, and releases it 
for use as an EDX terminal. 

. RESET NUMERIC EDIT key (#46) 

This key turns off the numeric edit feature for numeric fields. 
. SET NUMERIC EDIT key (#45) 

This key turns on the numeric edit feature for numeric fields, 
. DOUBLE ZERO key (#1 24) 

This key is ignored by the Communications Facility. 
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Output to Terminals 

The lOCP writes messages destined for a device station to the 4978 or 4980 that 
the station represents. Each message must begin with a 3270 command or 
STX/ESC (X'0227') followed by a 3270 command. The lOCP supports the same 
commands as a 3271 control unit, except for the copy command. It discards 
messages that contain a copy command. 
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Printer lOCP, $.100674 

The printer lOCP allows you to use Series/ 1 printers as if they were 3286 model 2 
printers or 3287 model 2 printers in SNA character string (SCS) mode. 

You can use the lOCP in these ways: 

• For communication between printers and host programs to which the Series/ 1 
appears to be a 3270 system. See example 1 in the chapter "Sample 
Configurations" on page 269. 

• For communication between printers and Series/ 1 programs. 

Hardware Requirements 

This lOCP supports Series/ 1 printers. 



EDX Requirements 



Station Definitions 






Include EDX terminal support in the EDX supervisor. Use the TERMINAL 
statement to define each printer. 



Define stations to represent: 

• ThelOCP. Name= $.100674, type=user. 

• Each printer. Type = device, subtype = printer. 

When you define the device stations, use station names that are different from the 
EDX terminal names. Link each device station with a station that represents an 
emulated printer or an appUcation program. If the printer device station is Unked 
to an LU station that represents a type 1 LU, use the CP F MODE command to 
change the device station's mode to SCS. (3270 is the default.) 



Data Set Requirements 

This lOCP uses data set $.SYSPRT to support printers as buffered devices. 



LU-1 Support 



When you hnk a printer station with an SNA LU station that represents a type 1 
LU, the printer station will receive SNA character string (SCS) data. As 
distributed, this lOCP does not support SCS data. You must link-edit the lOCP to 
include the support. 

To include LU-1 support link-edit object modules O$IO0674, O$IO0675, 
O$IO0676, and O$IO0677. 



^^^F 
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lOCP Operation Overview 



This lOCP consists of a main taslc and a subtask for each started device station. 
The main task processes commands to stop or halt the lOCP and commands to 
start, stop, or halt device stations. 



/r ^^ 



Each printer device subtask processes messages sent to the station that represents a 
printer. The lOCP makes the printer appear functionally as a 3286, or a 3287 in 
SCS mode to the program that sends data to it. The lOCP shares the printer with 
EDX. It enqueues on the printer only during a print operation. If the printer is 
busy when the lOCP needs it, the lOCP waits for the printer to become available. 

Figure 30 summarizes the 3270 functions and level of support that the printer 
lOCP provides. For more information about these functions, see the 32 71 Guide. 
SCS functions are described under "Page Formatting — SNA Character String 
Mode" on page 153. 



Function 



Yes 



Supported 



No 



Remote Command Codes 
Write (Fl) 
Erase/ write (F5) 
Erase/write alternate (7E) 
Read buffer (F2) 
Read modified (F6) 
Copy (F7) 
Erase all unprotected (6F) 

Write Control Character 
Reset MDT 
Keyboard restore 
Sound alarm 
Start printer 
Define printout format 



X 
X 
X 
X 
X 

X 



X 
X 
X 
X 
X 



X 






Printer Control Orders 
New line (NL) 
End of message (EM) 
Carriage return (CR) 
Forms feed (FF) 



X 
X 
X 
X 



Buffer Control Orders 
Start field (SF) 
Set buffer address (SBA) 
Insert cursor (IC) 
Program tab (PT) 
Repeat to address (RA) 
Erase unprotected to address (EUA) 



X 
X 
X 
X 
X 
X 



Figure 30 (Part 1 of 2). 3270 Functions Supported on Printer 
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Supported 
Function Yes No 

Card reader X 

Selector pen X 

Figure 30 (Part 2 of 2). 3270 Functions Supported on Printer 



Non-Display and Text Modes 



Printer Operation 



If the station that represents a printer is in non-display mode, the lOCP translates 
lowercase characters to uppercase. If the station is in text mode, the lOCP doesn't 
translate the data. Refer to the appropriate component book on hardware 
requirements for lowercase data. 



If the Communications Facility printer lOCP contains the LU-I support, a printer 
can operate in 3270 data stream mode or SNA character string mode (SCS). When 
a printer station is defined, it is in the 3270 data stream mode. You can use the CP 
F MODE command to set a printer station to either mode. If the lOCP does not 
contain LU-1 support, it rejects the start of a printer station in SCS mode. 

You can determine the printer's mode by using the CP Q PARM command to 
display the value of Q$DVD in the started printer's station block. Bit in Q$DVD 
of the printer's station block is on if the printer is in SCS mode and off if the 
printer is in 3270 data stream mode. 

The lOCP receives messages sent to a printer device station and processes them as 
a 3270 control unit does, according to the 3270 command and orders or SCS 
control codes in the data stream. If a message doesn't begin with STX/ESC 
(X'0227'), the lOCP processes the message as an erase/write command with start 
printer specified in the write control character. If the printer station is in 3270 data 
stream mode, the write control character specifies an 80-character print Une. If the 
station is in SCS mode, the print operation is unformatted. 

Printing doesn't begin until the lOCP receives a data stream that has the start 
printer bit on in the write control character (bit 4=1). The lOCP uses the 
PRINTEXT instruction to print data. 



Buffered and Unbuffered Support 



o 



All 3270 printers are buffered devices. Data sent to a 3270 printer is held in the 
printer buffer until the control unit receives a data stream that has the start printer 
bit on. 

Series/ 1 printers are not buffered devices. The lOCP uses data set $.SYSPRT as a 
printer buffer. When you define a printer device station and specify that the lOCP 
is to support it as a buffered device, a member with the same name as the station 
name is allocated in $.SYSPRT. If a printer station has a member in $.SYSPRT, 
the lOCP uses the member to hold data between print operations. 
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You can, for example, seiid a form such as an invoice with an erase/write 
command and the start printer bit off. The lOCP receives the data and saves it in 
$.SYSPRT. You can then send variable data, such as name and address, with write 
commands and the start printer bit on. Each such write command causes the lOCP 
to update and print the $.SYSPRT member. 

If a printer station has no member in $.SYSPRT, the lOCP supports it as an 
unbuffered device. The lOCP processes each data stream sent to the printer as if it 
were an erase/ write command; no data is retained between print operations. The 
data is not actually printed unless the write control character in the data stream has 
the start printer bit on. 

To change support for a printer station from buffered to unbuffered, use the EDX 
utility program $DIUTIL to delete its member from $.SYSPRT. To change from 
unbuffered to buffered, use $DIUTIL to delete the station definition from 
$.SYSNET, and then redefine the station as a buffered device. 



Page Formatting — 3270 Data Stream Mode 






A print operation is formatted when bits 2 and 3 of the write control character are 
not 0; the bits define a 40-, 64-, or 80-character print line. A print operation is 
unformatted when these bits are 0; printer control orders in the data stream 
determine line length. 

The lOCP processes printer control orders as a 3270 control unit does, as follows: 

• The FF order (forms feed, X'OC) is valid only when it immediately follows the 
write control character or a CR or NL order. The lOCP executes the FF 

order, for both formatted and unformatted print operations, by specifying ^r^x 

PRINTEXT operand LINE= 1. A vaUd FF order prints as a blank. The lOCP ^\^^J' 

doesn't execute an invalid FF order; it prints as "<" unless it is within a 
non-display field, in which case it prints as a blank. 

• The lOCP doesn't execute an NL order (new line, X'15') for a formatted print 
operation or if the NL is within a non-display field. It prints as "5" or a blank. 
Otherwise, the lOCP executes NL by specifying PRINTEXT operand SKIP=1. 

• The lOCP doesn't execute a CR order (carriage return, X'OD') for a formatted 
print operation or if the CR is within a non-display field. It prints as a blank. 
Otherwise, the lOCP executes CR by specifying PRINTEXT operand 
SKIP=0. 

• The lOCP doesn't execute an EM order (end of message, X'19') for a 
formatted print operation or if the EM is within a non-display field. It prints as 
"9" or a blank. Otherwise, EM terminates the print operation. 

Because the lOCP uses the PRINTEXT instruction, there can be conflicts between 
the page formatting specified in a data stream and that performed by EDX. EDX 
resets its line counter to and starts a new page when: 

• It executes a PRINTEXT instruction with LINE=0. 

• It processes a $E command. 

• It reaches the bottom of a page (as defined by the BOTM parameter of the 
TERMINAL statement). 
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A problem arises when both EDX and the program that sends print data reaUze 
that they've reached the bottom of a page, and the program then sends muhiple NL 
orders to skip to line 1 of the next page. EDX starts a new page before it receives 
the PRINTEXT SKIP= 1 instructions, which positions the printer beyond the top of 
the next page. If the program sends an FF order to start a new page, there is no 
problem; the PRINTEXT LINE=1 instruction causes a skip to line 1. 

If the program uses the FF order to start a new page, define the printed page size 
to EDX in the TERMINAL statement (for example, PAGSIZE=66, TOPM=3, 
BOTM=63). If the program uses multiple NL orders to start a new page, define 
the entire physical page size to EDX (for example, PAGSIZE=66, TOPM=0, 
BOTM=65). 

You must also consider how the operator can notify EDX that the forms have been 
positioned at the top of a page at the start of a print job. (The printer restore or 
mode switch doesn't do it.) If the printer is the one defined to EDX as 
$SYSPRTR, the operator can issue a $E command. Otherwise, the operator must 
run some program that executes a PRINTEXT instruction with LINE=0. The 
program can be one you provide, or the one that processes the CP SET LOG 
command. In the latter case, the operator can issue a CP SET LOG command for 
the printer and then another CP SET LOG command for the actual log device. 



Page Formattii^ — SNA Character String Mode 



In SCS mode, print operations are unformatted. Figure 3 1 Usts the SCS control 
codes that the Communications Facility supports. For more information about 
these control codes, see the 3287 Printer Component Description. 

Supported 
Function Yes No 

Back space (BS) X 

Bell (BEL) X 

Carriage return (CR) X 

Enable presentation (ENP) X 

End of message (EM) X' 

Form feed (FF) X 

Graphic escape (GE) X 

Horizontal tab (HT) X 

Inhibit presentation (INP) X 

Inter-record separator (IRS) X' 

Line feed (LF) X 

New Une (NL) X 

Set attribute (SA) X 

Set horizontal format (SHF) X 

Set vertical format (SVF) X 

Figure 31 (Part 1 of 2). SCS Functions Supported by the Communications FacUity 



9 Treated as an NL control code. 
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3270 Status Messages 



Supported 



Function 

Set line density (SLD) 
Transparent (TRN) 
Vertical channel select (VCS) 
Vertical tab (VT) 



Yes 

Xio 

X 
X 
X 



No 



Fi^e 31 (Part 2 of 2). SCS Functions Supported by the Communications Facility 

Nonprintable characters other than SCS control codes, including 3270 display 
attributes and orders, are replaced with a minus sign (-). 



The lOCP sends 3270 status messages to the printer station's direct link to report 
printer status. It sends a device end status message (X'C240') at the end of a print 
operation. It sends an intervention required status message (X'4050') if a 
PRINTEXT instruction fails with return code 5 (device not ready). It sends an 
equipment check status message (X'40C8') if a PRINTEXT instruction fails for 
any other reason. 
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Printer Errors 



If you're using a printer for pass-through to a host, the printer station is linked to a 
station representing an emulated 3286 or 3287 printer. After a successful print 
operation, the printer lOCP sends a device end status message to the emulated 
printer station, and the emulation lOCP sends it on to the host. This allows the 
host to transmit another message to the printer. If an error occurs during the print 
operation, the lOCP tests periodically to see if the problem has been corrected. 
When the error is cleared, the lOCP sends a device-end status message to the host 
and printing continues. 






mj^ 



10 Accepts 3, 4, 6, and 8 lines-per-inch. 
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7485 lOCP, $.100680 






The 7485 lOCP allows you to use 7485 terminals as if they were 3277 model 2 
terminals. $.100680 manages communication with 7485 terminals connected to the 
Series/ 1 by an asynchronous adapter. 

You can use the lOCP in these ways: 

• For communication between 7485 terminals and host programs to which the 
Series/ 1 appears to be a 3270 system. 

• For communication between 7485 terminals and Series/ 1 programs. 



Hardware Requirements 



1^ 



This lOCP supports the 7485 terminal model 53. Use of $.100680 requires one of 
these attachment features: 

• Feature programmable communications adapter with feature number 
2095/RPQ D02350. Up to eight 7485s can be attached locally with an 
RS422A electrical interface. When any of the terminals are being used the one 
at subaddress must be active; the station that represents it must be started 
first and stopped last. (Subaddress is the device address that is a multiple of 
8.) 

• Multifunction attachment (feature number 1310). Up to four 7485s can be 
attached locally with an RS422A electrical interface. The 7485s operate at 
9600 bits per second (bps). Be careful not to exceed the aggregate rate of the 
multifunction attachment. Refer to the Multifunction Attachment Feature and 
4975 Printer Description for more information. The information given for 3101 
terminals applies to 7485 terminals. 

• A terminal/host adapter is required for the 4950 or the 5170-495. On the 
4950, up to four terminals can be attached locally to the terminal/host adapter 
using an RS422A electrical interface. One terminal can be attached locally or 
remotely to the Personal Computer Asynchronous Communications Adapter 
(feature number 1502074) using an RS232C electrical interface. 

On the 5170-495, up to four terminals can be attached locally to the 
terminal/host adapter using an RS422A electrical interface. Up to two 
terminals can be attached locally or remotely to the terminal/host adapter 
using an RS232C electrical interface. 

You must strap the feature programmable communications adapter to match the 
7485 configuration, as explained in the EDX Installation and System Generation 
Guide. The information given for 3101 terminals appUes to 7485 terminals. 

No strapping is required for the multifunction attachment. The EDX supervisor 
definition statements ADAPTER and CFTERM define the 7485 configuration. 
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EDX Requirements 



Station Definitions 



7485 terminals are supported as Communications Facility terminals only; you /~\ 

cannot use them as EDX or work session controller terminals. %,-J^ 

For 7485s on a multifunction attachment, include EDX multifunction attachment 
support in the EDX supervisor, and use the ADAPTER statement to define the 
attachment. Use the Communications Facility CFTERM instruction to define each 

7485. 

Include EDX unmapped storage support in the EDX supervisor. 



Define stations to represent: 

. The lOCP. Name=$.IO06F0, type=user. 
• Each 7485. Type=device, subtype=3101F. 



Program Name Requirements 



To use the 7485 lOCP, you must rename it $.IO06F0. Either do not install 
$.IO06F0 or give it a different name. 



Supporting Multiple 7485s 



The lOCP can manage multiple 7485s concurrently. Although the 7485 operates (J i 

in interrupt-per-character mode, the instruction path length through the interrupt ^*«--^ 

handling code is generally short enough so that there is minimal interference with 
the operation of other 7485s and with any batch work. The exact number of 
devices that can be supported depends on processor speed, available processor 
storage, and other tasks being executed concurrently. 

The amount of available mapped and unmapped storage and the size of $.IO0680's 
dynamic storage area are the limiting factors in determining the number of 7485s 
that can be managed by $.100680. See "Planning Storage Requirements" on 
page 213 for a discussion on determining the amount of processor storage and 
dynamic storage required to support multiple 7485s. 



Supporting 7485s and 3101s 



If the 3101s are on asynchronous adapters, you must rename both lOCPs. Rename 
$.IO06F0 to $.100630, and then rename $.100680 to $.IO06F0. Define all the 
stations as 3 10 IF devices. Then use the $. CONFIG change conmiand to change 
the subtype of the stations that represent 3101 terminals to 3101. Changing the 
subtype does not alter the bit rate and auto-answer definition. 

When you start the stations, $.IO06F0 (the renamed $.100680) manages the 
stations defined as 3101F devices (7485 terminals). $.100630 (the renamed 
$.IO06F0) manages the stations defined as 3101 devices (3101 terminals). 
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lOCP Operation Overview 



The 7485 lOCP consists of a main task and a subtask for each started device 
station. The main task processes commands to stop or halt the lOCP and 
commands to start, stop, or halt device stations. Each device subtask processes 
data received from a 7485 and messages sent to the station that represents that 

7485. 



The lOCP makes the 7485 appear as a 3277 to the operator and to the programs 
that communicate with the terminal. Although the 7485 is an unbuffered device, 
the lOCP makes it appear as a buffered device. Device buffering is done in 
Series/ 1 processor storage. 

Figure 32 summarizes the 3270 functions and the level of support that the 7485 
lOCP provides. For more information about these functions, see the 32 71 Guide. 



Function 



Yes 



Supported 



No 






Remote Command Codes 
Write (Fl) 
Erase/ write (F5) 
Erase/write alternate (7E) 
Read buffer (F2) 
Read modified (F6) 
Copy (F7) 
Erase all unprotected (6F) 

Write Control Character 
Reset MDT 
Keyboard restore 
Sound alarm 
Start printer 
Define printout format 

Printer Control Orders 



X 
X 
X 
X 
X 



X 
X 
X 



X" 



X 



X 
X 



Buffer Control Orders 

Start field (SF) X 

Set buffer address (SBA) X 

Insert cursor (IC) X 

Program tab (PT) X 

Repeat to address (RA) X 

Erase unprotected to address (EUA) X 

Attributes 

Protected/unprotected X 

Figure 32 (Part 1 of 2). 3270 Functions Supported on 7485 






11 Printer control orders display on a 7485 the same as they do on a 3277. 
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Input from Terminals 



Supported 

Function Yes No 

Alpha/numeric X VJ' 

Automatic skip X 

High/normal intensity X 

Non-display X 

Selector-pen detectable X 

Modified data tag X 

Keyboard 

ENTER X 

PF1-PF12 X 

PA1-PA3 X 

CLEAR X 

ERASE EOF X 

ERASE INPUT X 

DEL X 

RESET X 

FM (field mark) X 

DUP X 

INS MODE X 

TEST REQ X 

CURSR SEL X 

Cursor movement X 

Lowercase alpha X 

Card reader X 

Selector pen X A^ 

Figure 32 (Part 2 of 2). 3270 Functions Supported on 7485 



The lOCP reads input from a 7485 and holds it in a device buffer in processor 
storage. When the operator presses a program attention key (see the section "7485 
Keyboard" on page 159), the lOCP formats the input data as a 3270/BSC data 
stream. The data stream is the same as if it had originated from a remote 3277 
model 2 terminal in response to a 3270 read modified command. 

If the station that represents the 7485 is in non-display mode, the lOCP translates 
lowercase characters to uppercase. If the station is in text mode, the lOCP does not 
translate the data. 

The lOCP sends the data as a Communications Facility message, specifying the 
device station as the origin. If the lOCP has a direct link vector, it specifies that 
station as the destination; otherwise, it specifies a null destination. 



o 
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7485 Keyboard 



Figure 33 shows the 7485 keyboard as supported by the 7485 lOCP. A 
description of the supported functions follows. Pressing keys that have a legend of 
"Ignored" causes the alarm to beep; nothing is entered into the device buffer. 
Pressing keys that have a legend of "Local Function" causes the indicated function, 
but no data enters the system. 
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The ALT key must be pressed and held to activate 
function shown on the front of the key. 



Figure 33. 7485 Keyboard 
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7485/3277 Key Functions 

The following keys correspond to the keys on the 3277 display station keyboard ^^ 

(see the 32 71 Guide) : i;^ J 

• Cursor movement keys 

The following keys move the cursor. They don't affect MDT bits. 

- Cursor up, down, left, right (#58, 59, 79, 80) 

- Tab key (#24) 

- Backtab key (#37) 

- New line key (#78) 

- Home key (#37) 

. ERASE EOF key (#44) 

When the cursor is located within an unprotected field, the ERASE EOF key 
clears character locations from the cursor location to the end of the field to 
nulls. It also sets the MDT bit to 1 . The cursor does not move. When the 
cursor is located at an attribute character or within a protected field, the 
ERASE EOF key disables the keyboard. No character locations are cleared; 
the cursor does not move; and the MDT bit is not set. 

• ERASE INPUT key (#23) 

This key clears all unprotected character locations to nulls, resets MDT bits to 

in unprotected fields, and repositions the cursor to the first unprotected 

character location on the screen. /^ 






. INS (Insert) MODE key (#38) 

This key switches the keyboard controls from normal mode to insert mode or 
from insert mode to normal mode. 

The cursor blinks while the keyboard controls are in insert mode. When the 
cursor is located within an unprotected field that contains null characters at or 
beyond the cursor location, pressing an alphanumeric key causes a character to 
be entered at the cursor location and sets the MDT bit to 1 . The character that 
was at the cursor location and all remaining non-null characters in the field are 
shifted right one location. After all null characters at or beyond the cursor 
location in the field are overwritten (or if there were no null characters), 
pressing an alphanumeric key causes the alarm to beep. 

. DEL CHAR key (#39) 

When the cursor is located within an unprotected field, the DEL key deletes 
the character from the location occupied by the cursor and sets the MDT bit to 
1. The cursor does not move. 

When the cursor is located at an attribute character or is within a protected 
field, the DEL key disables the keyboard. No character locations are cleared; 
the cursor does not move; and the MDT bit is not set. 



o 
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• RESET key (#17) 

This key resets a disabled keyboard. 

. FM (field mark) key (#18) 

This key enters a unique character code into the device buffer and sets the 
MDT bit to 1. The field mark character is X'lE'; it displays as a semicolon (;). 

. DUP key (#43) 

This key enters a unique character code into the device buffer, performs a tab 
key operation, and sets the MDT bit to 1. The DUP character is X'lC; it 
displays as an asterisk (*), 

• Program attention keys 

The following keys terminate an input operation and disable the keyboard. An 
attention identification (AID) character that identifies the key is generated, but 
the MDT bit is not affected. The AID is included in the 3270 data stream that 
results from the input operation. 

- CLEAR key (#2) 

The CLEAR key clears the device buffer to nulls, positions the cursor at 
location 0, and resets all MDT bits. 

- ENTER key (#87) 

- Program access keys 1, 2, 3 (#23, 43, 44) 

- Program function keys 1-12 (#19, 20, 21, 40, 41, 42, 60, 61, 62, 81, 82, 
83) 

7485 Key Functions 

The following keys provide functions that are not available on a 3277 keyboard. 

. PRINT key (#22) 

This key copies the contents of the screen to the EDX device defined as the 
7485 station's hardcopy device. If the station that represents the 7485 is in 
non-display mode, lowercase characters are translated to uppercase for 
printing. If the station is in text mode, lowercase characters are not translated. 

. REFSH (refresh) key (#22) 

This key displays the contents of the device buffer. 
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Overrun Considerations 



7485/3277 Keyboard Differences 

Because of the physical differences between 3277 and 7485 keyboards, two of the /'^ 

characters of the 3277 keyboard use different keys on the 7485 keyboard. These \, b 

characters are: 

3277 3101 

A (key #9) 

\ (key #36) 

The character shown on the face of the key displays, but the lOCP enters the 
equivalent 3277 character into the device buffer, 

Uppercase/Lowercase Support 

Two character sets are supported for the 7485 : uppercase (mono) and 
uppercase/lowercase (dual). 

The default character set for the 7485 terminal is uppercase. To change to a dual 
character set, use the CP F MODE command to change the mode to text for that 
station. 



Since the 7485 is unbuffered, overrun situations can occur. An overrun is most 

likely to occur when several operators simultaneously press typamatic cursor 

movement keys, causing two characters of data to be sent down the line for each 

keystroke. If an overrun does occur, the lOCP sends back an audible beep to the /^ ^ 

overrun device, and ignores the character in error. The keyboard may lock if \^-Jr 

characters are still being entered when the overrun is detected, causing 

'WAIT-SYSTEM BUSY' to display on line 25 of the screen. Press the RESET key 

(#17) to reset the keyboard. 



Changii^ Keyboard Functions 



You can change the functions of 7485 keys. To do so, you need to change the 
input interrupt handler module and, in some cases, the main module of the lOCP. 
The names of these modules are: 

lOCP MAIN Input Interrupt Handler 

$.100680 S$IO0680 S$IO0683 

The input interrupt handler processes each input character according to the 
definition in table BRINDEX. This table defines an index to branch table 
BRTABLE for the 128 values of the ASCII character set. There are four general 
groups of characters: numeric characters, alphabetic and other graphic characters, 
ignored control characters, and supported control characters. The input interrupt 
handler processes some of the supported control characters, and the main module 
processes others. The main module refers to characters by names equated to hex 
values. If you define different characters for functions processed in the main 
module, you'll need to change the EQU statements, which are located just before 
the executable code. 
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These are the supported control functions: 



ASCI 


[I Hex Function 


7485 Key 


68 


Reset keyboard 


#17 


07 


Alarm 




52 


Enter 


#87 


09 


Tab 


#24 


50 


Enter insert mode 


#38 


50 


Exit insert mode 


#38 


OD 


New line 


#78 


IB 


Escape 




49 


Field mark 


#18 


6D 


Dup 


ALT/#43 


51 


Delete 


#39 



The main module processes the reset keyboard and enter functions. The input 
interrupt handler processes the other functions. 

When the input interrupt handler receives an escape character, it proceeds 
according to the next character it receives. The main module processes these 
escape sequences: 



ASCII Hex 


Function 


7485 Key 


1B71-1B73 


PF1-PF3 


ALT/#19-ALT/#21 


1B74-1B76 


PF4-PF6 


ALT/#40-ALT/#42 


1B77-1B79 


PF7-PF9 


ALT/#60-ALT/#62 


1B7A-1B7C 


PF10-PF12 


ALT/#81-ALT/#83 


1B6C 


Erase input 


ALT/#23 


1B62 


CLEAR 


#2 


1B64 


PAl 


#23 


1B65 


PA2 


#43 


1B66 


PA3 


#44 


1B63 


Hardcopy 


#22 


1B6B 


Refresh 


ALT/#22 



Note that PF1-PF9 must be contiguous values. 

The input interrupt handler processes these escape sequences at label ESCOK: 



ASCII Hex 


Function 


3101 Key 


1B41 


Cursor up 


#58 


1B42 


Cursor dov^^n 


#59 


1B43 


Cursor right 


#80 


1B44 


Cursor left 


#79 


1B48 


Home 


ALT/#37 


1B6E 


Erase EOF 


ALT/#44 


1B32 


Back tab 


#37 



Any other escape sequence causes the alarm to beep. 
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Output to Terminals 



The lOCP receives messages sent to device stations and interprets them as '^ 

3270/BSC data streams. It processes messages as a 3271 control unit does, \ J/ 

according to the 3270 command and orders in the data stream. It supports the 
same commands as a 3271, except for the copy command. It discards any message 
that contains a copy command. 

If a message doesn't begin with STX (X'02'), the lOCP processes the message as a 
write command with keyboard restore specified in the write control character. 



Changing ASCII/EBCDIC Translation Tables 



Restrictions 



You can change the tables that $.100680 uses for translating terminal input from 
ASCII to EBCDIC and terminal output from EBCDIC to ASCII. You may want 
to do this, for example, to support your national character set. 

There are four tables (all in module S$IO068T): 

. EBCD2ASC, the EBCDIC to ASCII translation table. 

. ASC2EBCD, the ASCII to EBCDIC translation table used when a 3 1 1 
station is in text mode (retains lower case input). 

• CNVTUPCS, the ASCII to EBCDIC translation table used when a 3 101 
station is in non-display mode (translates lower case input to upper case). 

• BRINDEX, the branch index table that defines each ASCII value as an /^ '^■. 
alphabetic character, a numeric character, a supported control character, or an \^^j^ 
ignored value. 

For example, the codes for the U.S. character double quote (") are EBCDIC '7F' 
and ASCII '22'. Suppose that EBCDIC '7F' is instead a national character whose 
ASCII code is '5C'. To support that character, change the tables as follows: 

1. Change table EBCD2ASC at offset '7F' to the ASCII code, '5C'. 

2. Change table ASC2EBCD and/or CNVTUPCS at offset '5C' to the EBCDIC 
code, '7F'. 

3. Change the branch index table at offset '5C' to '24' to define the national 
character as a numeric character or to '28' to define it as an alphabetic 
character. 



Do not cancel $.100680 using the EDX $C command. If you do, the unmapped 
and mapped storage obtained by the lOCP is not returned to the system. Use CP 
H $.IO06F0 (the renamed $.100680) to terminate the lOCP user station and its 
device stations. 
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PC Connect Disk-Server lOCP, $.I01CC8 

The PC Connect disk-server lOCP allows PC users in a local area network (LAN) 
to access Series/ 1 disks as if they were PC disks. A PC can have a maximum of 26 
disks, from A to Z. Since the PC considers drives A and B as its local diskettes, the 
lOCP can support only 24 emulated PC disks for each LAN. If the gateway PC 
has a hard disk attached, it treats that as a local disk and the number of emulated 
PC disks is reduced by the number of hard disks attached. 

The lOCP recognizes emulated PC data sets on the Series/ 1 that are consecutively 
active. It disregards all active data sets after it encounters an inactive data set. For 
example, if data sets d, e, f , and h are active, the lOCP only recognizes d, e, and f 
because g is inactive. 

This lOCP requires the PC Connect lOCP, $.100 AA8, and the emulated PC disk 
management utility program, $.DSFORM. 



Hardware Requirements 



EDX Requirements 



^»i.», 






Use of this lOCP requires the Series/ 1 -PC Connect Attachment (feature number 
4000) and a Series/ 1 disk device, such as a 4967. 



Include the Communications Facility PC Connect support modules in the EDX 
supervisor. The required modules are: 

• CSPCCINT, the PC Connect initialization routine 

• CSPCCIPL, the PC Connect initiaUzation call routine 

• CSPCCOPN, the PC Connect microcode data set(s) open routine 

• CSPCCPTC, the PC Connect microcode patch load routine. 

Include the appropriate disk support for your Series/ 1 disk device. Use the DISK 
statement to define each Series/ 1 disk. For increased performance, define the 
volumes to be managed by this lOCP as performance volumes on the DISK 
statement. Include EDX Local Communications Controller support (LCCAM) in 
the EDX supervisor. 



Personal Computer Requirements 



Station Definitions 



Use of this lOCP requires Series/ 1 -PC Connect (5719-CNl). For more 
information on hardware and software requirements for the PC and the 
Series/ 1 -PC Connect, see the IBM Series/ 1 -PC Connect for the Event Driven 
Executive Communications Facility. 



Define stations to represent: 

. ThelOCP. Name=$.I01CC8, type=USER. 

• Each volume. Type=VOL. 
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Link the volume station to the associated PC node station. 

lOCP Operation Overview It j 

The PC Connect disk-server lOCP consists of a main task and a subtask for each 
started volume station. The main task processes commands to stop or halt the 
lOCP and commands to start, stop, or halt the volume stations. The subtask 
processes three I/O requests from the gateway PC — directory, read, and write. 
The subtask also processes messages sent from $.DSFORM — create, delete, and 
rename data sets. 

The PC Connect lOCP, $.IO0AA8, receives the PC disk I/O requests from the 
LAN and sends it to the volume station. The PC Connect disk-server lOCP, 
$.101 CCS, checks the message queue on the volume station and retrieves the I/O 
requests to be executed by the lOCP. The lOCP sends the message to the PC 
node, which is directly linked to the volume station. This is a one-way link: the 
volume station is linked to the associated PC node station. 

Messages to and from the Gateway PC 

The following is a list of messages that flow between the volume station and the 
gateway PC: 

. DIRECTORY 

This request is issued when the gateway PC is IPLed. The response provides 

the Disk Operating System (DOS) with the number of emulated PC disks and 

their basic input/ output support (BIOS) parameter blocks. The lOCP /'^ '\ 

performs this function by reading a control data set, $.DSPROF, that is created 4. # 

by $.DSFORM. It logs all the active emulated PC disks in a directory table 

when the volume station is started. 

. READ 

This request is passed from DOS to the lOCP. DOS requests a read of a 
number of sectors starting at a certain sector on the PC disk. The PC converts 
this information into the number of blocks to read starting at a certain block 
number on the corresponding data set on the Series/ L The lOCP gets this 
information, issues the read, and sends the result back to the gateway PC. 

. WRITE 

This request is passed from DOS to the lOCP. DOS requests a write of a 
number of sectors starting at a certain sector on a PC disk. The PC converts 
this information into the number of blocks to write starting at a certain block 
number on the corresponding data set on the Series/ 1. The lOCP gets this 
information, issues the write, and sends the result back to the gateway PC. 



o 
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Messages from $.DSFORM 

There are two kinds of messages that are sent from $.DSFORM when an emulated 
PC disk is created or deleted. The messages are 10 bytes long and contain the 
Series/ 1 data set name representing the emulated PC disk and a flag word 
indicating whether the emulated PC disk has been created or deleted. When the 
lOCP receives these messages, it updates the corresponding entry in the directory 
table and frees the data set control block (DSCB), if it is not needed. 
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Series/1-to-Host SNA lOCP, $.I014E8 



\ 



The Series/ 1-to-Host SNA lOCP allows you to connect a Series/ 1 and a host 
processor in a Systems Network Architecture (SNA) environment. The Series/ 1 
appears to the host as a type 2 PU (a cluster controller) with type 2 LUs 
(terminals) and types 1 and 3 LUs (printers). There may be up to 32 LUs 
(emulated terminals and printers) associated with each PU, but the practical 
maximum is less. If you define too many LUs to EDX-SNA, the program will 
exceed the EDX partition size. The maximum number of LUs varies according to 
the size of the Communications Facility PU buffers, and the size of S$POOL. 

The lOCP communicates with the EDX Secondary SNAl network through the 
EDX Secondary SNAl Licensed Program (5719-SXl), which is described in the 
EDX Secondary SNAl Guide. 

The lOCP also communicates with the EDX Secondary SNA2 network through the 
EDX Secondary SNA2 Licensed Program (5719-XX9), which is described in the 
EDX Secondary SNAl Guide. EDX Secondary SNA2 supports up to four PUs. 

Applications running in the host communicate with the Series/ 1 the same way that 
they communicate with an actual remote 3270 SNA/SDLC system, as described in 
the 3274 Guide. 

Although the SNA lOCP operates in an SNA environment, it sends and receives 
3270/BSC data stream messages. It removes BSC and 3270 control characters 
from messages before sending them to the host. During a type 2 or 3 session, it 
appends BSC and 3270 control characters to messages received from the host 
before sending them to their destination. During a type 1 session, messages 
received from the host are sent to their destination unchanged. 

You can use the lOCP in these ways: 

• For communication between host programs and terminals or printers attached 
to the Series/ L Example 3 in the chapter "Sample Configurations" on 
page 269 includes EDX Secondary SNAl and host system definitions. 
Example 4 in the chapter "Sample Configurations" on page 269 includes EDX 
Secondary SNA2 and host system definitions. 

• For communication between host programs and Series/ 1 programs. 



Hardware Requirements 



EDX Requirements 






The SNA lOCP has no hardware requirements other than those of the 
Communications Facility and EDX-SNA. 



You can choose between EDX Secondary SNAl support and EDX Secondary 
SNA2 support. The requirements they impose on EDX are described in the EDX 
Secondary SNAl Guide and in the EDX Secondary SNAl Guide. 
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EDX-SNA Definitions 



You define the EDX-SNA configuration by changing the SNA configuration data /f \ 

set(s) provided, assembling it, and linking it with the EDX-SNA object module. V..J''^ 

EDX Secondary SNAl provides only one configuration data set. EDX Secondary 
SNA2 also provides one configuration data set, but you may duplicate, edit, 
assemble, and link up to 4 PUs. You must define the configuration before 
EDX-SNA is started, and you can't change the configuration dynamically. 

You can define up to 4 PUs for EDX Secondary SNA2 and from 1 to 32 LUs per 
PU to the SNA network. 

For EDX Secondary SNA2, you must edit the SNAINIT data set to specify 
whether your PUs will be activated when $SNA is started, and what partitions will 
be used by the PUs. Specifying partitions to be used by PUs also saves storage. 

It is recommended that PUs are not loaded into the partition that contains $.CF. If 
the PUs are loaded in the same partition that contains $.CF, after $.CF has been 
loaded, $.CF is unable to load transient programs it requires to process the CP 
commands. You can avoid this by activating your PUs before starting the 
Communications Facility, or by using the SNAINIT data set to specify partitions to 
be used by the PUs. See the EDX Secondary SNA2 Guide for more information on 
defining your PUs. 

The parameters for defining each PU are determined mostly by the type of line and 
modem used. These parameters are described in the EDX Secondary SNAl Guide 
and EDX Secondary SNA2 Guide. The parameters that have an impact on 
Communications Facility usage are BUFSIZ and DCBNO. 



BUFSIZ specifies the size of the buffers to be used. The value specified for 
BUFSIZ depends on the size of the messages expected to flow through EDX-SNA. 
The default of 256 is recommended. DCBNO specifies the maximum number of 
consecutive frames that may be received or sent. DCBNO=7 is recommended; this 
corresponds to the specifications for the SDLC 3274. 

You specify LUs to EDX-SNA by number. You must either specify to allow 
EDX-SNA to assign the next available logical unit number, or assign LU numbers 
that begin with 1 and proceed sequentially up to 32. The number assigned to each 
LU corresponds to the LOCADDR (local address) definition in the NCP that 
controls the line. The LU number and the PU station are used to map the 
Communications Facility station definitions to EDX-SNA LUs. (Note that some 
LUs defined to EDX-SNA may be used by other application programs, and in that 
case need not be defined to the Communications Facility.) 

The EDX Secondary SNAl Guide and EDX Secondary SNA2 Guide give complete 
instructions for defining an EDX-SNA configuration. 



Host System Definitions 



Define the SDLC line, the PU, and the LUs to the network and to host subsystems 
(if necessary) as a standard SDLC 3274 with attached terminals. Define the PU as 
a type 2 (SNA cluster controller). 

Define the LUs to host subsystems just as if they represented real devices attached 
to an SDLC 3274 control unit. Define the LUs that represent terminals as type 2 
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and the LUs that represent printers as types 1 and 3. Be sure that the LU type is 
consistent with the corresponding Communications Facility station definitions. 
LUs that will be connected to terminals must be defined as terminals, LUs that will 
be connected to printers must be defined as printers. Note that the only screen size 
supported by the Communications Facility is the 1920-character screen, 80 x 24 
characters. The Communications Facility accepts binds for alternate screen sizes if 
the subtype of the LU is 3287 or 3289. 



Station Definitions 



Define stations to represent: 

• ThelOCP. Name=$.I014E8, type=user. 

I • For EDX Secondary SNA 1: One PU. Type=PU, subtype=3274ES. 

I . For EDX Secondary SNA2: From 1 to 4 PUs. Type=PU, subtype=3274ES. 

I • From 1 to 32 LUs for each PU station defined. Type=LU, subtype=3277, 

3278, or 3279 for type 2 LUS; subtype=3286 or 3289 for type 3 LUs; and 
subtype=3287 or 3289 for type 1 LUs. See "Planning Storage Requirements" 
on page 213 to determine how many LUs your configuration can support. 

Link each station that represents an LU with a station that represents a real 
terminal or printer or an application program. For printer stations linked to type 3 
LUs, use the CP F MODE command to set the printer station's mode to 3270. For 
printer stations linked to type 1 LUs, set the mode to SCS. (The default mode is 
\ 3270.) No link is required for the PU station. 

Logon Parameter Definitions 

To initiate communication with the host, the name and mode of an SNA 
application are required. There are three ways you can supply these parameters: 

• You can define up to three sets of logon parameters for the PU station, as 
explained in the chapter "Defining Stations" on page 45. You can also define 
a logon ID for an LU station — a number from 1 to 3 that corresponds to one 
of the sets of logon parameters defined for the PU station. When the LU 
station is started, the lOCP initiates a session with the specified SNA 
application. If you defined a user data field for the LU station, the lOCP sends 
the data to the SNA application. You must use this method if there is no 
terminal operator involved in a session (for example, if the session is with a 
printer). 

• You can define logon parameters for the PU station, but define no logon ID for 
an LU station. When the LU station is started, the lOCP sends a prompt 
screen to the station to which the LU station is linked. The prompt screen, 
shown in Figure 34 on page 172, shows the logon parameters defined for the 
PU station. The terminal operator may select one of these and, optionally, 
enter a password and/or data in the user data field. 






An alternate logon prompt screen, which has separate fields for USERID and 
PASSWORD, is provided for connections to 8100 Distributed Processing 
Executive (DPPX) systems. Procedures for installing this alternate panel are 
described in "Installing the Communications Facility" on page 251. 
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SELECT LOGON APPLICATION FROM LIST: 
I: APPLID TSO MODE LU2256 
2: APPLID CICS MODE LU2256 
3: APPLID CICS MODE ST032743 

OR, SELECT 4 AND ENTER APPLID AND MODE: 
4: APPLID MODE 



ENTER SELECT ION==> _ 



USER DATA==> 



OR, SELECT AND CHANGE DEFAULT APPLID AND MODE VALUES (1-3 ABOVE) 
CHANGES WILL BE REFLECTED IN ALL FUTURE LOGONS 



Figure 34. SNA Logon Prompt Screen 



• The terminal operator can define the logon parameters. The operator can 
select option and enter or change any of the three sets of default logon 
parameters. The information is recorded in the PU station block and in the PU 
station's definition in $.SYSNET; it applies to all subsequent logons. 
Alternatively, the operator can select option 4 and enter logon parameters to 
be used only for this session. 

If the session is to be initiated by the host, you define the logon ID as HOST or an 
ID that has no application associated with it. In either case, when the LU is 
started, a host-initiated session begins. You need not specify any logon parameters. 



lOCP Operation Overview 



The SNA lOCP consists of one main task and a subtask for each active LU station. 
The main task processes commands to stop or halt the lOCP and commands to 
start, stop, or halt LU stations. Each LU subtask controls the initiation and 
termination of a session between EDX-SNA and an LU. It processes data received 
from the host and messages sent to the LU station. 

EDX-SNA handles all transmission over the SDLC line that connects the Series/ 1 
and the host. It also manages SNA protocol, pacing, and error recovery. 

Note that there is no task associated with the PU station. The PU station block 
contains information for the associated LU stations — buffer size, PU number (for 
EDX Secondary SNA2), and logon parameters. 
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The lOCP uses one of two logon methods to establish communication with an SNA 
appUcation. If you specified a logon ID for the LU station when you defined it, 
session initiation begins depending on which mode the LU station is in. If the 
mode is NOPC, it begins when the LU station is started. If the mode is PC, session 
initiation begins when a device end is received. If you didn't specify a logon ID or 
if you specified 0, the lOCP issues a prompt for an appUcation when the station is 
started. The operator at the terminal to which the LU station is Unked enters logon 
information, as explained in the section "Logon Parameter Definitions" on 
page 171. The lOCP builds an EDX-SN A logon parameter Ust and sends it to 
EDX-SNA. 



Session States 



EDX-SNA attempts to estabUsh a session by sending an INIT SELF request to the 
host. The host application either rejects the request or responds by returning a 
BIND request. If EDX-SNA finds the BIND parameters defining the session to be 
satisfactory, it accepts the BIND and completes session estabUshment before 
returning to the lOCP. The lOCP further checks the BIND session parameters and 
ends the session if they are unsatisfactory. (BIND session parameters that are 
acceptable for LU-1, LU-2, and LU-3 are described in the 3274 Guide.) 



After a session with the host appUcation has been estabUshed, the lOCP processes 
session traffic by passing through several states corresponding to the states of the 
session. These correspond to processing states of a 3274 under the same 
conditions. 






The states defined are: 

• Between brackets. (A transaction is called a bracket in SNA terminology.) No 
transaction is currently active. 



The lOCP waits for input from either the Communications FacUity or 
EDX-SNA. If both send messages simultaneously, input from the 
Communications Facility takes precedence. If a message transmitted during 
this state does not include an end bracket (EB) indication, the state is changed. 
If there is no EB, the next state is determined by the next system to send. If a 
message flows from the Communications FaciUty to SNA, the lOCP always 
gives SNA the right to send and the lOCP enters the RECV state. If a 
message flows from SNA to the Communications Facility, SNA may or may 
not give the lOCP the right to send. If the lOCP gets the right to send, the 
lOCP enters the SEND state; otherwise it enters the RECV state. If the 
device being used is a printer, the lOCP enters the printer busy state. 

SEND. The next message should be from the Communications FaciUty to 
EDX-SNA, but the host may request the right to send. The lOCP waits for a 
message to be placed on the LU station's queue. If the appropriate host 
command is received, the state may change to RECV to aUow the host to 
transmit. If a message is sent to the LU station, the lOCP sends it on to 
EDX-SNA, and changes the LU state to RECV. 



LU-2 protocol does not allow the secondary LU (the lOCP) to end a bracket, 
so the state wiU never change from SEND to between brackets as a result of an 
inbound, or Series/ 1-to-host, message. Printer devices supported by LU-1 and 
LU-3 protocol never enter the SEND state. 
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RECV. The next message should be from EDX-SNA to the Communications 
Facility. The lOCP waits for messages or control information from 
EDX-SNA. If a message arrives, the lOCP sends it as a Communications 
Facility message, specifying the LU station as the origin. If the lOCP has a 
direct link vector, it specifies that station as the destination; otherwise, it 
specifies a null destination. If an EB is received, the state is changed to 
between brackets. If EB is not received, the state may still be changed. If the 
device being used is a printer, the state is changed to printer busy pending 
completion by the printer. Otherwise, if SNA gives the IOC? the right to send, 
the state changes to SEND. 
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ERPl. A status indication has been sent to the LU station, indicating that the 
device to which it is linked is unavailable and that the host application has been 
notified. The LU will wait for an indication from the Communications Facility 
that the device is available. When this occurs, the host application is notified, 
and the LU goes into the RECV state waiting for a message from the host. 

Printer busy. The lOCP has received a message for a printer. It has sent the 
message to its destination and is waiting for a device end status message. If a 
message is received from SNA, it is rejected with a device busy sense value 
(X'0814'). When a device end status message is received from the 
Communications Facility, a positive response is sent, signaling that the printer 
is ready. If the EDX-SNA message contains an EB, the state is changed to 
between brackets; if not, the state is RECV. 



Session Termination 



A session ends when the host application sends an UNBIND request. This may be 
the result of a particular message to the application, such as a LOGOFF, or the 
lOCP finding that the LU station has been stopped. In the latter case, the lOCP 
issues an EDX-SNA NETTERM, causing a RSHUTD (request shutdown) request 
to be sent to the host. 



A.J' 



If the session was established automatically when the station was started (a logon 
ID was defined to the LU station), the station is in either UBSTOP mode or 
UBRETRY mode. If UBSTOP, the station is stopped. If UBRETRY, the lOCP 
tries to rebind the session. 

Normally, when the session is ended, the station is stopped. To establish another 
session, you must start the station again. However, you may use the CP F MODE 
command to set the UBRETRY mode of operation. When the mode is 
UBRETRY, you must stop the LU station to end the session. 



Messages from the Host 



Each message received from the host must contain a 3270 command that is 
supported for the type of LU to which the message is sent. 
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These commands are acceptable for an LU station whose subtype is 3277: 

Erase all unprotected 

Read modified 

Read buffer 

Write 

Erase write 

Erase write alternate 

Read modified all (processed as read modified) 

These commands are accepted for an LU station whose subtype is 3286 or 3287: 

Erase all unprotected 

Write 

Erase write 

Erase write alternate 



Basic Mode Input 






Record Mode Input 



Any command is accepted for an LU station whose subtype is 3278 or 3279. The 
lOCP assumes that the destination of the message is a device attached to a real 
3274 control unit, and that the control unit will perform error checking. 



During a type 2 or type 3 session, if the LU station is in basic mode, the lOCP 
reformats the message so that it looks like those sent by the 3270 emulation lOCP. 
It appends STX/ESC (X'0227') to the beginning of the message, and ETX (X'03') 
to the end of the message before sending the message to its destination. During a 
type 1 session, messages are sent to their destination unchanged. 



During a type 2 or type 3 session, if the LU station is in record mode, the lOCP 
removes the following control information before sending the message to its 
destination: 

• The first 2 bytes (command code and write control character) 

• The third through fifth bytes, if the third byte is SBA (set buffer address) 

• The sixth and seventh bytes, if the third byte is SBA and the sixth byte is SF 
(start field). 

During a type 1 session, messages are sent to their destination unchanged. 



Printer Operation 



When the lOCP receives data for an emulated printer station (LU type 3286, 3287, 
or 3289), with the start printer bit on in the write control character, it sends the 
message to its destination and sets the LU state to printer busy. It sends a positive 
response to the host, which indicates that the printer is again ready, when a 
3270/BSC device end status message is sent to the LU station. The host will not 
send more data for the printer until it receives the positive response. (If it does, the 
lOCP rejects the data with a device busy sense value.) 
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The program that manages the real printer to which the emulated printer is linked is 
responsible for sending a device end status message to the emulated printer station 
when the print operation is complete. 

The program that manages the real printer is also responsible for retrying a print 
operation when the printer is not ready. The lOCP assumes that a print operation 
will complete successfully once it has sent the data to its destination. If the 
program that manages the real printer sends back an intervention-required status 
message, the lOCP ignores it. 

The lOCP that manages printers retries print operations, when necessary, and 
sends the required device end status message. If you write an lOCP to manage 
printers or an application program that processes data for emulated printers, you 
must do the same. The format of a status message is: 

. A 4-byte heading: SOH (X'01')/%/R/STX (X'02'). 

• 2 bytes for the control unit and device address, which the 3270 emulation 
lOCP fUls in. 

• The 2-byte status/sense code; X'C240' for device end. 
. ETX (X'03'). 



Messages to the Host 



When the lOCP receives messages destined for LU stations, it sends them on to 
EDX-SNA, It modifies messages before sending them, according to whether they 
contain basic mode data or record mode data. 
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Basic Mode Output 



Record Mode Output 



If a message begins with DLE (X'lO') or STX (X'02'), the lOCP assumes that the 
message is a correctly formatted 3270 data stream. It removes the DLE (if any), 
the STX, and the next 2 bytes (the 3270 poUing address). The lOCP removes the 
last byte of the message if it is an ETB (X'26') or ETX (X'03'). 



If a message doesn't begin with DLE or STX, the lOCP appends 3 bytes to the 
beginning of the message: 

X'7D' ENTER key attention ID 

X'4040' Cursor location (row 1, column 1) 



Remove and Non-Remove Mode 



The lOCP operates in remove mode (except for messages from the program 
dispatcher), unless you specify otherwise. As a result, if a message is sent to an LU 
station when the host has the right to send, the lOCP discards the message. You 
can run the lOCP in non-remove mode. If you do, the host program must be aware 
of it, because data sent to the host may not be a response to the last message the 
host sent to the Series/ 1. The lOCP sets itself to remove mode when it is started. 
If you want to set non-remove mode, do so after the lOCP is started. 
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Error Reporting 
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Messages from the program dispatcher are handled differently, because the 
program dispatcher is a transaction processor and cannot synchronize its session. 
When an LU station is linked to a station whose name is $.PD or begins with the 
characters $.PD, it always operates in non-remove mode. If a message is received 
when the Series/ 1 does not have the right to send, the message is left on its queue, 
and the host is signalled that the Series/ 1 wishes to send. When the host gives the 
right to send, the lOCP sends the message. 

Certain levels of the Communications Facility/Host (Program Number 5668-979) 
documentation state that you must include a CP Modify command in your 
$.SYSPD data set to set $.I014E8 to non-remove mode. This is no longer 
necessary. 



The lOCP reports error conditions to the SNA host application, using either SNA 
negative responses with sense bytes or LUST AT commands with sense codes. The 
32 74 Guide contains possible sense codes for an LU-2 session implemented on a 
3274. The lOCP uses a subset of these codes. Some are not discernible to the 
lOCP because of the distance to the end user. Others do not occur because the 
Communications Facility queues messages. EDX-SNA detects and handles many 
of the error conditions. 

Figure 35 lists the sense codes that the lOCP returns as a result of 3270 status 
messages sent to an LU station, or other causes as described. 



SNA Sense 


BSC Status 


Description 


1002 




RU too long. Returned if SNA message 
exceeds PU station buffer size value. 


1003 


4060, 
40C1 


Function not supported. Also returned if 3270 
command validation fails in lOCP. 


0802 


C250 


Intervention required. 


081C 


C6D8, 
C4C4, 
40C4 


Request not executable — not possible to 
recover from error. 


0829 




Change direction required. Returned if a 
message with a 3270 read-type command has 
end bracket or does not have change direction. 


082A 




Presentation space altered; command was 
executed. Returned if the Communications 
Facility terminal or program sent a message 
while LU was in RECV state, and then the 
host sent a write-type command. 


082B 


C6C4 


Device available, presentation space integrity 
lost. 



Figure 35 (Part 1 of 2). Sense Codes Returned by SNA lOCP 
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Restrictions 



SNA Sense 


BSC Status 


Description 


0831 


xxlx, xxx4 


LU component disconnected. Device/terminal 
power off, cable disconnected. 


0843 




Required function manager synchronization 
not supplied. RUs containing start print bit 
must require definite response, or exception 
response RU must carry change direction. 


084A 




Presentation space altered; command was not 
executed. Returned if the Communications 
Facility terminal or program sent a message 
while LU was in RECV state, and then the 
host sent a read-type command. 



Figure 35 (Part 2 of 2). Sense Codes Returned by SNA lOCP 



FM headers are not supported. The lOCP rejects a BIND that allows FM headers. 

The lOCP does not support the 3270 copy command. 

The lOCP accepts the 3270 read modified all command, but processes it as a read 
modified command. 



The lOCP does not support the sending of multiblock messages to the host, 
handles each message sent to an LU station as a single complete message. 



It 









The lOCP does not provide sufficient protocol to allow implementation of request 
definite response (RQD) support in SNA. SNA messages with RQD are processed, 
but in some cases positive responses are returned even though error conditions are 
encountered within the Communications Facility. Avoid RQD wherever possible 
when using the SNA lOCP. 

The lOCP does not provide any message mapping services except as described for 
record mode output. If the data going to the host is to be processed by any host 
mapping services, the appropriate 3270 orders must appear in the data stream. 
Messages created by real 3270 devices or by 4978/4980/3101/7485 devices as 
supported by the Communications Facility are formatted correctly. If a user 
program creates messages, it must format those messages correctly. 

The lOCP accepts the BIND for 3286 and 3287 LU3 stations, 3278 and 3279 LU2 
devices, and LUl devices. It assumes that the LU is associated with a real device 
that can handle alternate screen sizes. The Communications FaciUty only supports 
a 24 by 80 screen size and a 1920-byte printer buffer size for emulated devices. 

See the EDX Secondary SNA I Guide and the EDX Secondary SNA 2 Guide for 
restrictions imposed by EDX-SNA. 
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Communications Facility Data Sets 



The Communications Facility, as you receive it, includes data sets used to hold 
information the Communications Facility needs for its operation. Some of the data 
sets are required for all Communications Facility configurations; others are 
optional. During the installation process, you copy these data sets to your disk. 
Then you can use various methods (explained in the description of each data set) to 
add information to the data sets. 

This chapter explains how to enlarge the supplied partitioned data sets. Then it 
describes the suppUed data sets, plus EDX data sets and PC Connect microcode 
patch data sets that the Communications Facility uses. 



Enlarging Partitioned Data Sets 






If your configuration is large, the data sets as supplied may not be big enough to 
hold all the information you need to store in them. To make a partitioned data set 
bigger, use the EDX utility $DISKUT1 to allocate space for a data set of the size 
you require. Then use the EDX utility $DIUTIL to initialize it as a partitioned data 
set and to copy members from the old data set into the new one. 

Be sure you allocate records for the directory as well as for the data set's members. 
Each record in the directory of a partitioned data set, except the first, can contain 
16 directory entries; the first can contain 15. For example, if you need space for 
40 members of five records each, you should allocate 203 records: 200 for 
members and three for the directory. 

See the Event Driven Executive Operator Commands and Utilities Reference for 
information about $DISKUT1 and $DIUTIL. 



Network Configuration Data Set ($.SYSNET) 



The network configuration data set ($.SYSNET) is the data set that contains the 
definitions of all the stations in a node and of remote stations that will be 
communicated with from that node. $.SYSNET is a required partitioned data set; 
the Communications Facility can't be started without it. As supplied by IBM, it is 
an empty data set with space for 47 members. 

Before you can start a station, there must be a definition of the station in 
$.SYSNET. You may enter and modify station definitions using the $. CONFIG 
utility or the command processor commands. 
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Each station definition is a one-record member in $.SYSNET; the name of the 
member is the same as the name of the station. 

Once you have defined a station in $.SYSNET, you can delete that definition only 
through the delete function of the EDX utility $DIUTIL, Deleting a member only 
marks it as deleted; it doesn't free the space the member occupies. Therefore, it is 
recommended that you compress $.SYSNET after deleting station definitions from 
it. Note that the compress function must not be performed while the 
Communications Facility is in operation. 

$.SYSNET must reside on the same disk or diskette volume as the control program 
($.CFS or $.CFD) unless the control program resides on a disk device with a 
fixed-head volume. In that case, $.SYSNET must reside either on the fixed-head 
volume or on the same disk volume as the control program. 

When a station that has a disk queue is active, the Communications Facility 
maintains control information in the station's $.SYSNET member. Therefore, 
queuing of messages to disk is most efficient if $.SYSNET resides on a fixed-head 
volume. 






Message Data Set ($.SYSMSG) 



J 



The message data set ($.SYSMSG) is the data set that contains the text of error 
messages and informational messages issued by the Communications Facility and, 
optionally, by user programs. 

$.SYSMSG is a required partitioned data set; the Communications Facility can't be /^ 

started without it. It need not, however, contain any members. If you need to \ 

conserve disk storage, you can replace the $.SYSMSG data set supplied by IBM 
with a small empty partitioned data set. If you do, log messages will contain 
identifying and variable information but no fixed text. 

$.SYSMSG must reside on the same volume as the Communications Facility 
control program. 

Each member of $.SYSMSG contains the messages for a particular component of 
the Communications Facility. The name of the member is the same as the 
2-character code at the beginning of each message that identifies the component. 
Each member contains 99 messages (not all of which need be used). 

As suppUed by IBM, $.SYSMSG contains nine members: 

CA Channel attach lOCP messages 

CF Control program messages 

CP Command processor messages 

10 I/O control program messages 

11 I/O control program messages 

12 I/O control program messages 
PD Program dispatcher messages 
PN 3270 panel design aid messages 
SN SNA lOCP messages 

You can create your own error messages and alter existing messages by using the ■ ^ 

$. CONFIG utility. Each new member that you create requires 25 records. As \^ 
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supplied, $.SYSMSG is large enough so that you can create one member before 
you need to enlarge the data set. 



Initialization Data Set ($.SYSIPL) 



The initialization data set ($.SYSIPL) contains commands that are executed each 
time the Communications Facility is started. 

$.SYSIPL is an optional sequential data set. If it exists, it must reside on the same 
volume as the Communications Facility control program. 

As supplied by IBM, $.SYSIPL contains ten records with a /* statement. You can 
use any EDX text editor to enter commands into $.SYSIPL. One record is required 
for every two statements. The last command must be followed by a /* statement 
to indicate the end of the list of commands. See the Operator's Guide for an 
example of a $.SYSIPL data set. 



Printer Data Set ($.SYSPRT) 






The printer data set ($.SYSPRT) is a partitioned data set that contains members 
used to support printers as buffered devices. 

$.SYSPRT is required if you use the printer lOCP, $.100674. It is also required 
when you define a station with either the CP DEF command or the $. CONFIG 
utility program. It must reside on the same volume as the program that uses it — the 
I/O control program, the define command processor, or $. CONFIG. 

$.SYSPRT contains three types of members: 

• Image store: Eight records used to load the 4978 image store. 

• Control store: 16 records used to load the 4978 control store. 

• Printer station member: An 8-record member for each printer station to be 
supported as a buffered device. The member name is the same as the station 
name. If a particular printer doesn't have a member in this data set, it is 
supported as an unbuffered device. See the description of the printer lOCP, 
$.100674, in the chapter "Using the Supplied Input/Output Control 
Programs" on page 71, for more information. 

The $.SYSPRT data set as supplied by IBM contains space for three printer station 
members. One of these members is allocated, if you so request, when you define a 
printer station. 

If you don't use $.100674 and you need to conserve disk storage, you can replace 
the $.SYSPRT data set supplied by IBM with a small empty data set. 
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4978 Data Stream Data Sets ($.RPQCSO and $.RPQISO) 



$.RPQCSO and $.RPQISO are the control and image stores for the 4978 data 
stream RPQ, D02428. These data sets are required only if you use the data stream 
lOCP, $.100670, to control 4978 or 4980 terminals. They must reside on the same 
volume as the I/O control program. 



4978 EDX Data Sets ($4978CS0 and $4978IS0) 



$4978CS0 and $4978180 are the control and image stores for the 4978 terminal 
that are distributed with EDX. They must reside on the same volume as the I/O 
control program. 



,:**^~\ 
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4980 Data Stream Data Sets ($4980CSA, $4980ISA, and $4980R0A) 

$4980CSA, $4980ISA, and $4980R0A are the data sets required for 
Communications Facility support of the 4980 as a 3277. These data sets must 
reside on the IPL volume if you are using $.100670 to control 4980 terminals. 

4980 EDX Data Sets ($4980CS0, $4980IS0, and $4980R01) 

EDX requires data sets $4980CS0, $4980180, and $4980R01 for support of the /T^ 

4980. They must reside on the IPL volume. ^_ y 

Panel Data Set ($.SYSPNL) 

The panel data set ($.SY8PNL) is a partitioned data set that contains panels 
displayed by the panel design aid ($.PANEL), the sample program ($.CFMENU) 
and the 8NA I/O control program ($.I014E8). It is required only if you use any 
of those programs; it must reside on the same volume as the program. 

As supplied by IBM, $.8Y8PNL contains 16 members, each of which contains a 
panel description as follows: 

CFMENU The panel used by $.CFMENU. 

PHA8En The six prompting panels used by $,PANEL, where n is the number 

of the design phase. Phase 4 has two panels, one for protected 
fields and one for unprotected fields. 

HELPjcy Tl^e seven help panels used by $, PANEL, x is the number of the 

design phase. >^ is 1 for the first help panel of those phases that 
have two panels, j is 2 for the second or only help panel of a phase. 

8NALOGON The standard panel used by the 8NA I/O control program. 

8NALOG02 An alternate panel used by 8 100 DPPX users of the SNA I/O 
control program. 
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You can use $.PANEL to modify these supplied panels, but be sure that you 
change only the contents of fields. If you rearrange fields or change their 
attributes, the programs that use the panels may not work correctly. If you modify 
any of the panels used by $. PANEL itself, first make a copy of $.SYSPNL with a 
different name or on a different volume. Modify the panels in the second data set 
and then copy them to the original $.SYSPNL. 

$.SYSPNL contains no space for additional members. Allocate other data sets for 
application program panels, as described in the Programmer's Guide. 



Program Dispatcher Data Set ($.SYSPD) 



The program dispatcher data set ($.SYSPD) contains CP commands, path 
definitions, transaction definitions, and transactions that are to be processed when 
the program dispatcher is started. It is a sequential data set and is required only if 
you use the program dispatcher. 

The chapter "Creating $.SYSPD" on page 187 explains the contents of this data 
set in detail. 



IPL Transaction Data Set ($.SYSLCC) 






The IPL transaction data set ($.SYSLCC) contains IPL transactions used to IPL 
remote nodes on a Local Communications Controller ring. $.SYSLCC is an 
optional sequential data set. It is required if you do remote IPLs of any type, but is 
actually used only to process hardware IPL requests initiated at. a remote node, as 
described in the chapter "Communications Facility Components" on page L It 
must reside on the same volume as the program that processes IPL transactions, 
$.PDIPL. 

As supplied by IBM, $.SYSLCC contains ten records with a /* statement. You 
can use any EDX text editor to enter transactions into $.SYSLCC. One record is 
required for every two statements. The last transaction must be followed by a /* 
to indicate the end of the list of transactions. Any statement that begins with an 
asterisk is ignored. 

The format of each statement is: 

name IPL transaction 

where name is the 8-byte station name of the remote node to be IPLed; the IPL 
transaction begins at the ninth byte. For the format of the IPL transaction, see the 
Operator's Guide. 
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Emulated PG Disk Control Data Set ($.DSPROF) 



The emulated PC disk control data set ($.DSPROF) contains information about all 
the emulated PC disks on a Series/ 1 volume. $.DSPROF is created by 
$.DSFORM, the emulated PC disk management utility program, when a command 
to create, delete, rename, or list data sets is entered. It has 24 entries — each entry 
represents an emulated PC disk. For each emulated PC disk created, deleted, or 
renamed, the corresponding Series/ 1 data set name, data set size, and an active 
flag will be updated in $.DSPROF. $.DSPROF data set exists for each Series/ 1 
volume used to contain emulated PC disks. A maximum of 24 emulated PC disks 
can be created for each Series/ 1 volume. 



PC Connect Microcode Patch Data Set ($PCCROn) 



$PCCRO« is the data set required to support PC Connect. It is used by the PC 
Connect initialization routines and it must reside on the IPL volume. 

When you IPL the Series/ 1, the Communications FaciUty initialization module 
CSPCCPTC reads the EC level for each Series/ 1 -PC Connect Attachment and 
loads the microcode patches from the appropriate data set. 



X.25 Call ID Data Set ($.SYSX25) 






The X.25 call ID data set ($.SYSX25) contains 2-digit call IDs associated with /T >, 

X.25 network addresses used to establish virtual calls. \_J^ 

It is a sequential data set and is required only if you use the X.25 lOCP 
($.IO0AB8). It must reside on the same volume as the X.25 lOCP. 

As supplied by IBM, $.SYSX25 contains 10 records with a /* statement. You can 
use any EDX text editor to enter call IDs and network addresses into $.SYSX25. 
The last address must be followed by a /* statement to indicate the end of the list 
of addresses. Any statement that begins with an asterisk is ignored. 

The format of each statement is: 

call- id name call-addr comment 

where: 

call-id is any 2-digit decimal ID between 1 and 99. 

name is any 1- to 8-character name of your choice. 

call-addr is the 1- to 15-digit X.25 network address to be associated with the 

call ID. 

comment is an optional comment field. It is never examined. 

The parameters may start in any column and must be separated by at least one 
blank. See "Example 13: X.25 Connection Between Series/ Is through an X.25 
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Network" on page 392 or "Example 14: X.25 Connection between a Series/ 1 
and DTEs" on page 406 for sample $.SYSX25 data sets. 



Work Session Controller Data Set ($.WSCIMG) 



The work session controller data set ($.WSCIMG) is a partitioned data set that 
contains images that can be displayed through the work session controller and areas 
used by application programs to save data. $.WSCIMG is required only if you use 
the work session controller. It must reside on the same volume as the work session 
controller, $.WSC. 

As supplied by IBM, $.WSCIMG contains one member: 

MENU The image used by the work session controller sample program, 

$.WSMENU. 

It also contains 29 directory entries and 82 member records that are available for 
your images and save areas. 

You can use the EDX utility $IMAGE to create screen images and then transfer 
them to the $.WSCIMG data set using the utility program $.WSCUT1, as described 
in the Programmer's Guide. Each image member requires eight records. 

Your application programs can use the save areas through the work session 
controller save (SV) and restore (RS) commands, also described in the 
Programmer's Guide. Use the EDX utility $DIUTIL to allocate save area members 
\ of whatever size your application requires. The member name of a save area must 

be the same as the terminal name that the program is using for the session in 
progress. 



Work Session Controller Image ($.MENU) 



$.MENU image is described under "Work Session Controller Data Set 
($.WSCIMG)," in the format created by the EDX utility $IMAGE. The 
Communications Facility doesn't use this data set. It is provided so that you can 
modify the image. You may want to do this, in conjunction with modifying the 
sample programs that use it, to suit your installation's transaction-processing 
requirements. Use $IMAGE to modify the image and then use $.WSCUT1 to 
transfer it to data set $.WSCIMG. 



Disk-Queue Data Sets 



A data set is required for each station that uses disk-queued messages. See the 
chapter "Creating Disk-Queue Data Sets" on page 207 for information about 
these data sets. 



O 
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Creating $.SYSPD 



$.SYSPD is the data set that contains commands, path definitions, transaction 
definitions, and transactions that are processed when the program dispatcher is 
started. You need to create a $.SYSPD data set for each Series/ 1 where the 
program dispatcher runs. The data set must reside on the same volume as the 
program dispatcher. 

This chapter describes the contents of $.SYSPD and the statements that you use to 
define paths and transactions. The chapter "Communications Facility 
Components" on page 1 explains how the information you supply in $.SYSPD 
governs the program dispatcher's actions. The chapter "Sample Configurations" 
on page 269 contains several examples of $.SYSPD data sets. 



$.SYSPD Contents 



Commands 



$.SYSPD is a sequential data set divided into four sections by /* statements: 

Commands 

/* 

Cell and path definitions 

/* 

Transaction definitions 

/* 

Transactions 

/* 

As supplied by IBM, $.SYSPD contains ten records with four /* statements. Use 
any EDX text editor to enter the data you require between the /* statements. The 
program dispatcher ignores any statement that begins with an asterisk. 



The first section of $.SYSPD contains commands, which the program dispatcher 
sends to the command processor for execution. You can enter any CP or PD 
commands that you want to be executed when the program dispatcher is started. 
For example, you might enter commands to start the stations that represent 
physical connections between cells. The Operator's Guide gives the syntax of 
commands. 
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Cell and Path Definitions 



The program dispatcher builds its path table from the definitions you enter into the 
second section of $.SYSPD. You can enter a CELL statement to define the local 
cell, PATH statements to define paths to remote cells, and a RESERVE statement 
to reserve space in the path table. The section "$.SYSPD Definition Statements" 
gives the syntax of these statements. 



Transaction Definitions 



Transactions 



The program dispatcher builds its transaction table from the definitions you enter 
into the third section of $.SYSPD. You can enter TID and EQU statements to 
define transactions, RTE statements to define reroute entries, and a RESERVE 
statement to reserve space in the transaction table. The section "$.SYSPD 
Definition Statements" gives the syntax of these statements. 



The fourth section of $.SYSPD contains transactions, which the program 
dispatcher routes to the appropriate transaction-processing program. You can 
enter any transaction you want to be processed when the program dispatcher is 
started. For example, you might enter a SYST SP transaction to notify CSPDIO 
(the remote disk module) that the program dispatcher is active, or you might enter 
transactions to start your transaction-processing applications. The Operator's Guide 
gives the syntax of IBM-supplied transactions. 

See "Remote IPL" on page 37 for restrictions on sending broadcast transactions. 






$.SYSPD Definition Statements 



Syntax Notation 



This section gives the details of the format and operands of the $.SYSPD definition 
statements — the statements that you can insert into the second and third parts of 
$.SYSPD. First, here's an explanation of the syntax notation that's used to 
describe the statements. 



Each statement format in this chapter appears in a box with two columns: 



Operation 


Operand 







Operation Field. This field contains the statement name. 

Operand Field. This field contains the operands associated with the statement. 

The following conventions are used within the format descriptions: 

• Words in BOLD CAPITAL letters must be coded exactly as shown. Commas 
must also be coded exactly as shown. 
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• Words in italics are symbols for which you must substitute actual values. 

• Brackets ([ ]) indicate that the operand or suboperand is optional. For 
example, if the syntax of an operand is shown as: 

[[A],[B],[C]] 

then you could leave the operand out entirely; or you could code any of these 
variations: 

A,B,C 

A,B 

A„C 

A 

,B,C 

,B 

„C 

• Braces ({ }) indicate a group of mutually exclusive operands or values, of 
which you can code only one. 

• A vertical bar ( | ) separates the mutually exclusive items within braces. 
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CELL — Define the Local CeU 



CELL Syntax 



The CELL statement defines the local cell's identifier. Enter one CELL statement 
in the second section of $.SYSPD. If you omit the CELL statement, the default 
cell identifier is two EBCDIC zeros. 



CELL 


cellid 



CELL Operands 



CELL Example 



cellid 

is a 2-character cell identifier. Any two characters except ?? and ** are valid. 

CELL SI 

This statement assigns the identifier SI to the local cell. 



'\ 
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EQU — Define Equivalent Transaction 



The EQU statement defines a transaction that has the same attributes as another 
transaction, except as specified by optional operands. EQU gives you a simple way 
to define transactions with identical or similar attributes. Enter EQU statements in 
the third section of $.SYSPD. 



EQU Syntax 



EQU Operands 



EQU 


tranid-1 
tranid-2 

[[typeivnm.m] 

[H] 



tranid-1 

is the 1- to 4-character identifier of the transaction whose attributes are being 
defined. 



f^\ 



tranid-2 

is the 1- to 4-character identifier of the transaction whose attributes are to apply 
to the transaction tranid-1. tranid-2 must be defined by a TID statement. 



type 



is a 2-digit transaction type code, as explained in the description of the TID 
statement. If you omit this operand, the type defined for tranid-2 appUes. 






indicates that the program defined for tranid-2 is purgable. 



indicates that this transaction is a 3270 data stream that the program dispatcher 
is not to modify. If you omit this operand, the specification defined for tranid-2 
applies. 



R 



indicates that the program load retry Umits are to be ignored for this transaction. 
If you omit this operand, the specification defined for tranid-2 applies. 



H 



indicates that the transaction is to be held on the queue of station $.PHjcjcxx, 
where xxxx is the transaction identifier. 
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EQU Example 



EQU TR3B TR3A ^-^ 

\ 
This statement defines a transaction with identifier TR3B that has the same "^ 

attributes as transaction TR3A. 
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PATH — Define a Path 



PATH Syntax 



PATH Operands 






PATH Examples 



The PATH statement defines the path to a remote cell. Enter PATH statements in 
the second section of $.SYSPD. 



PATH 


station-name 
ycellid 

{{,S\,C,prefix}] 
[[P],[H]] 



station-name 

is the 1- to 8-character name of the station that represents the path to a remote 
cell. 

cellid 

is the 2-character identifier of the remote cell. 



indicates that transactions routed over this path are 3270 data streams that the 
program dispatcher is not to modify. 



indicates that the program dispatcher is to do binary data conversion of the 
transactions routed over this path. Use this parameter only for a BSC path to a 
non-Series/ 1 host. 

prefix 

is a 4-character prefix to be appended to transactions routed over this path. 



indicates that this is the preferred path over which transactions for unknown 
cells are to be routed. You may define only one preferred path in each cell. 



H 



indicates that transactions for this path are to be held on the queue of station 
$.PHxjc, where xx is the identifier of the remote cell. 



PATH E3277A,S2 

This statement specifies that transactions with cell identifier S2 are to be sent to 
station E3277A. 

PATH HOSTTERM,CI, ,CSSN P 



This statement specifies that transactions with cell identifier CI or with an 
unknown cell identifier are to be prefixed with CSSN and sent to station 
HOSTTERM. 
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RESERVE 



RESERVE — Reserve Table Entries 



O 



The RESERVE statement reserves space in the program dispatcher's tables. If you 
have reserved space in the tables, you can use the PD I command to insert path or 
transaction definitions after the program dispatcher is started. Enter a RESERVE 
statement in the second section of $.SYSPD to reserve space in the path table. 
Enter a RESERVE statement in the third section of $.SYSPD to reserve space in 
the transaction table. 



RESERVE Syntax 



RESERVE 


number 



RESERVE Operand 



number 

is the number of entries to be reserved. 



RESERVE Example 



/* 

CELL S1 

PATH E3277A,S2 

RESERVE 2 

/* 

TID IPL $.PDIPL 22 

RESERVE 4 

/* 

/* 



This example reserves two entries in the path table and four entries in the 
transaction table. 
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RTE — Define a Reroute Entry 



The RTE statement defines the destination cell for a transaction whose primary cell 
identifier is the local cell. You can't have both an RTE statement and a TID 
statement for the same transaction. Enter RTE statements in the third section of 
$.SYSPD. 



RTE Syntax 



RTE Operands 



RTE 


tranid 
cellid 
[H] 



tranid 

is a 1- to 4-character transaction identifier. 

cellid 

is the 2-character identifier of the cell to which the transaction is to be routed. 






RTE Examples 



H 



indicates that the transaction is to be held on the queue of station $.PHxjcjcx, 
where xxxx is the transaction identifier. 



o 



RTE PRT1 C3 

This statement specifies that transactions with identifier PRTl are to be routed to 
cell C3 instead of being processed in the local cell, as their primary cell identifier 
specifies. 

RTE PRTl C3 H 

This statement specifies that transactions with identifier PRTl are to be held on the 
queue of station $.PHPRT1. When the hold is released (by a PD F command or a 
SYST RH transaction), the held transactions are routed to cell C3. 
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TID — Define a Transaction 






TID Syntax 



TID Operands 



The TID statement defines a transaction to be processed in the local cell. Enter 
TID statements in the third section of $.SYSPD. 



TID 


tranid 

program 

[, [ vo/t/m^], [partition], [prefind]] 

[[0';'^],[P],[S],[R]] 

[H] 



tranid 

is a 1- to 4-character transaction identifier. 

program 

is the 1- to 8 -character name of the program that is to process the transaction. 






volume 

is the 1- to 6-character name of the volume where the program resides. The 
default is the IPL volume. 

partition 

is the partition where the program is to be loaded. Specify one of the following: 







to mean any available mapped partition. is the default. 



ltol6 
to mean the specified mapped partition. If the partition does not exist or is 
not mapped, the partition specification is set to in the transaction table. 

-lto-16 

to mean any available mapped partition except the one specified. 



CF 



to mean the $.CF partition. 

NCF 

to mean any mapped partition except the $.CF partition. 

prefind 

indicates whether or not a prefind of the program's data sets and overlays is to 
be performed when the program dispatcher is started. Omit the operand to 
enable prefind; specify N to disable prefind. 
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type 

is a 2-digit transaction type code. The first digit indicates the 
transaction-processing program's type. Specify one of these values: 

1 A single-transaction program that processes one transaction and then 
terminates. 

2 A multitransaction program that processes multiple transactions and then 
terminates. 

3 A continuous program that remains in storage, processing transactions, until 
it is told to stop. 

4 A continuous, reentrant program that remains in storage, processing 
transactions, until it is told to stop. 

The only significance of these codes to the program dispatcher that a type 1 
program is loaded (if the second digit of the type code so specifies) each 
time the transaction is entered, even if the program is already in storage; 
type 1 and 2 programs are not purgable. 

The second digit of the type code indicates what the program dispatcher is to do 
when it receives the transaction. Specify one of these values: 

Load a program; do not create a station; do not send the transaction. 

1 Load a program; create a station and its associated message queue; do not 
send the transaction. 

2 Load a program; create a station and its associated message queue; send 
the transaction to the station. 

3 Do not load a program; create a station and its associated message queue; 
send the transaction to the station. 

P 

indicates that the program is purgable; the program dispatcher can tell it to stop 
if its storage is needed for some other transaction-processing program. You can 
specify that the program is purgable only if the transaction type code is in the 
range 30-43. 

S 

indicates that the transaction is a 3270 data stream that the program dispatcher 
is not to modify. 

R 

indicates that the program load retry counts are to be ignored for this 
transaction. When there is no storage available for the program, the load is to be 
retried until it succeeds or until the program dispatcher is shut down. 

H 

indicates that the transaction is to be held on the queue of station S.PHjcxjcx, 
where xxxx is the transaction identifier. 

Figure 36 summarizes the transaction types. The default transaction type is 10. 
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Figure 36. Transaction Types 



TID Examples 



TID MENU $.WSMENU 22 

This statement specifies that the program $.WSMENU is to process transactions 
with transaction identifier MENU. When the program dispatcher is started, it will 
do a prefind for $.WSMENU. When the program dispatcher receives a MENU 
transaction, it will load $.WSMENU from the IPL volume into any available 
partition, if the program isn't already in storage. It will create station $.WSMENU, 
if the station doesn't already exist; and it will send the transaction to $.WSMENU. 

TID RPT REPORT, USRLIB,NCF 20 

This statement specifies that transactions with transaction identifier RPT are to 
cause program REPORT to be executed. When the program dispatcher is started, 
it will do a prefind for REPORT. When the program dispatcher receives an RPT 
transaction, it will load REPORT from volume USRLIB into any available partition 
except the one in which $.CF is loaded, if the program isn't akeady in storage. 

TID T327 T327PGM,,,N 22,, S 






This statement specifies that transactions with identifier T327 are 3270 data 
streams to be processed by program T327PGM. When the program dispatcher is 
started, it will not do a prefind for T327PGM. When the program dispatcher 
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receives a T327 transaction, it will load T327PGM from the IPL volume into any 
available partition, if the program isn't already in storage. It will create station 
T327PGM, if the station doesn't already exist. It will send the transaction, without 
modification, to T327PGM. ^ 



Definitions for IBM-Supplied Transactions 



This section shows the TID statements for IBM-supplied transactions. Enter the 
ones you require in your $.SYSPD data sets. You can enter them as shown, or you 
can supply the volume name or the partition where the program is to be loaded. 
Note that no TID statement is required for SYST transactions. 

Transaction Scheduler: 

TID SCHD $.PDSCHD,,,N 32 

Remote Management Functions, Host Cell: 

TID HMU $.HMU 22 

Remote Management Functions, Remote Cells: 

TID RMU $.RMU 22 

Remote IPL: 

TID IPL $.PDIPL 22 

Remote Disk Support, Cells where Disks are Located: \^ 

TID <I0> $.PD<IO>,,,N 32 

Work Session Controller: 

TID WSC $.WSC 42 

Work Session Controller Sample Program: 

TID MENU $.WSMENU 22 



Using a Private Data Set 



When you're testing transaction-processing applications, you may want to use a 
program dispatcher data set whose name is other than $.SYSPD or one that resides 
on a different volume from the program dispatcher. You can do so by starting the 
program dispatcher as follows: 

1. Use the AL command of utility program $.UT1 to create a station block named 
$.PD with a network address appropriate to your configuration. 

2. Use the SE command of utility program $.UT1 to send a message to $.PD, 
specifying the data set name and volume name you want to use. The text of 
the message is xxxxxxxxyyyyyy, where xxxxxxxx is the 8-character data set 
name and yyyyyy is the 6-character volume name. 



\j) 
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3. Use the EDX $L command to load $.PD. 

The program dispatcher now starts with the data set you specified for this session 
only. 



Creating $.SYSPD 205 






i J 



206 Communications Facility Design and Installation Guide 






Creating Disk-Queue Data Sets 



A disk-queue data set is a data set on disk that is used to hold low-priority 
messages sent to, but not yet received by, a particular station. Each station that is 
to have a disk queue requires a separate disk-queue data set. This chapter explains 
how to create disk-queue data sets and how to display information about them. 



Disk-Queue Data Set Specifications 



g^^ 
\^'' 



To create a disk-queue data set, you must allocate the data set, initiaUze it, and 
assign it to a station. You can use the worksheet shown in Figure 37 on page 208 
to record the information you will specify when you create disk-queue data sets. 

Fill in the worksheet as follows: 

Station Name 

is the 1- to 8 -character name of the station to which this disk-queue data set is 
assigned. 

Data Set Name 

is the 1- to 8-character name of the disk-queue data set. 

Volume Name 

is the 1- to 6-character name of the volume on which the data set resides. The 
volume must not be a fixed-head volume. 

Size 

is the size of the data set, expressed as the number of 256-byte records. The 
first record of the data set is used for control information. The remaining 
records are used to hold messages. Each message includes a 24-byte message 
header and requires one or more entire records. 

To determine the size required for a disk-queue data set, you must have some 
idea of the size of the messages that will be sent to the station and the maximum 
number of messages that will accumulate in the data set. If you have enough 
disk storage, start out by allocating data sets larger than you expect to need. 
After the data sets have been in use for a while, determine the maximum space 
ever used (see "Displaying Information about Disk-Queue Data Sets" on 
page 211) and adjust the data sets' sizes accordingly. 

The data set for $. WASTE (the undeliverable message station) requires more 
space than most disk-queue data sets, for two reasons. First, the messages aren't 
received (unless you've written a program to do so); they accumulate in the data 
set until you use utiUty program $.UT2 to process them. Second, each 
undeliverable message results in two messages being written to the data set: a 
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Disk-Queue Data Set Worksheet 



f. 



Station Name 


Data Set Name 


Volume 


Size in Records 


Active 

(Y/N) 


Warning 
Level % 


Warning 
Dead- 
band % 


Overlay 
Mode 

(Y/N) 






































































































































































































































































































































































































































































































































































































Figure 37. Disk-Queue Data Set Worksheet 



22-byte reason message that contains the date, time, and a reason code, and the 
undeliverable message itself. 
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Active 

indicates whether or not the disk queue is to be active when the station is 
started. 

Warning Level % 

is the level, expressed as a percentage of total data set capacity, at which you 
want a system log message issued when the data set contents have exceeded that 
level. If you specify that you want no warning messages, the level is set to 0. 

Warning Deadband % 

is the level, expressed as a percentage of total data set capacity, that controls the 
number of warning messages issued. After a warning message is issued, no more 
are issued until the data set contents drop below the warning level by the amount 
of the deadband and then rise above the warning level again. The default 
warning deadband is 10%. 

Overlay Mode 

indicates whether or not the data set is to be used in overlay mode. In overlay 
mode, when the data set doesn't have enough free space for a new message, the 
new message overlays the oldest messages already in the data set. If the warning 
level is other than 0, this overlaying causes a system log message to be issued. 

In nonoverlay mode, a message is not written to the data set unless there is 
enough free space. When there isn't enough space for a message, the sender 
gets a return code indicating that the message was not sent. 






Allocating Disk-Queue Data Sets 



Use the EDX utility program $DISKUT1 to allocate disk-queue data sets. For 
example: 

AL QUEFILE 50 D 



Initializing Disk-Queue Data Sets 



Use the Communications Facility utility program $.DSINIT to initialize the data 
sets with the control information required for disk queuing. The program prompts 
you for the required information. 
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Here is an example: 

I 



> $L $.DSINIT ^^ 



$.DSINIT 22P,01 :52:06, LP= 4000 

THIS PROGRAM INITIALIZES PREVIOUSLY ALLOCATED 

DATA SETS FOR USE AS MESSAGE QUEUES 

ENTER DATA SET NAME, VOLUME: QUEFILE^^ 

INITIALIZE QUEFILE,EDX002 ? Y 

IS THE DATA SET TO BE COMPLETELY INITIALIZED ? Y 

CAPACITY WARNING LEVEL TO BE SPECIFIED ? Y 80 

THE DEFAULT DEADBAND VALUE FOR WARNING MESSAGES IS 10%, OK ?Y 

IS THE DATA SET TO OPERATE IN OVERLAY MODE ? N 

QUEFILE,EDX002 HAS BEEN INITIALIZED FOR MESSAGE QUEUING 

MORE DATA SETS TO INITIALIZE ? N 

$.DSINIT ENDED AT 01:52:54 



If you need to initialize multiple data sets with identical sizes and specifications, 
you can allocate and initialize one of them and then use the EDX utility program 
$C0PYUT1 to make copies with different names. 

You can also reinitialize disk-queue data sets with $.DSINIT, either completely or 
partially. You can change the warning level, the warning deadband, 
overlay/nonoverlay mode, and the high water mark (maximum data set level 
reached during operation). The description of $.DSINIT in the Operator's Guide 
gives more information about reinitiaUzing disk-queue data sets and an example. 



Assigning Disk-Queue Data Sets to Stations 



Notice that you don't specify a station name when you initialize a disk-queue data 
set. The data set doesn't show which station it's assigned to (although it does show 
which station last used it). Instead, the definition of a station in $.SYSNET shows 
which disk-queue data set is currently assigned to that station. 

This arrangement gives you considerable flexibility in associating disk-queue data 
sets with stations. For example, if a disk-queue data set fills up, you can stop the 
station, assign it another data set, restart the station, and save the first data set for 
later processing. You can deUberately collect messages for later processing by 
assigning a data set to a station that doesn't receive the messages sent to it; when 
you're ready to process the messages, stop the station and assign the data set to 
another station that does receive and process its messages. What you can't do is 
assign the same data set to more than one station at a time. 

You can assign a disk-queue data set to a station when you define the station, using 
either $. CONFIG or the CP DEF command. You assign the data set by specifying 
its name, volume, and whether or not it is to be active when the station is started. 
The data set doesn't have to exist when you do this; you can allocate and initiaUze 
it later. You must allocate and initialize it before you start the station. 



12 The default volume name for the disk-queue data set is the one where $.DSINIT 
resides. 



/if ~\\ 
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You can use the CP FILE NAME command or the $. CONFIG CHANGE 
command to modify the disk-queue data set assignment for an existing station. 
You can assign a data set to a station that doesn't have one, assign a different data 
set to a station that does have one, or unassign a data set. You can use the CP F 
DISKQ command to change the status of a station's disk queue from active to 
inactive, or vice versa. 



Displaying Information about Disk-Queue Data Sets 



The CP FILE PARMS command displays the names and volumes of the disk-queue 
data sets assigned to stations. If a data set is open (is currently in use by the 
station), the command also displays the information you specified for the data set, 
the number of messages it contains, the percentage of capacity currently in use, and 
the high water mark. 

The CP ST command displays, for an open disk-queue data set, the number of 
messages it contains, the percentage of capacity currently in use, and the high 
water mark. 

Utility program $.DSINIT displays the current high water mark when you request a 
partial reinitialization of a disk-queue data set. 



Stations That Don't Need Disk Queues 






There are some types of stations for which disk queues are never used. Either the 
messages sent to the station are placed on the queue of some other station, no 
messages are sent to the station, or the few messages that are sent are queued in 
storage. 

The stations that don't need disk queues are: 

A user station that represents an I/O control program 

A Une station of subtype 327 IC, 327 IE, LCC, PCC, CA, DTE, or DCE 

A terminal station of subtype 3271 

An SNA physical unit station 

An alias station 

A remote station 

A remote node station that is not on the local node's Local Communications 
Controller ring or the Series/ 1 -PC Connect Attachment. 
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Planning Storage Requirements 



I . i 



This chapter will assist you in determining how much processor storage the 
Communications Facility will require. 

The Communications Facility occupies space in the following parts of an EDX 
system: 

• The EDL language extensions and remote disk support become part of the 
EDX supervisor. They must be located in partition 1. 

• The system storage pool (S$POOL) and system tables (CSXSYS) become part 
of the common area. 

• The Communications Facility control program ($.CFS or $.CFD), the 
Communications Facility message pool (CFBUF), the command processor 
transients, and the optional Series/ 1-to-Series/l lOCP must all be in the same 
partition, called the $.CF partition. 

• The remaining Communications Facility programs can run in any partition in 
which the common area is mapped. 

Figure 38 on page 214 shows the partition structure of an EDX system with the 
Communications Facility installed. 

To plan how much storage the Communications Facility will require, you need to 
consider: 

• Which Communications Facility programs you will use. 

• How large the various working storage areas used by the Communications 
Facility need to be to satisfy your requirements. 

• Which programs will run in which partitions. 

• The number of partitions and their sizes. 



Communications FacUity Programs 

Figure 39 on page 216 shows the size of each executable component of the 
Communications Facility. The sizes listed may not always be accurate because of 

gfHk maintenance changes to the modules. Always check the latest program directory for 

%f the current module sizes. 
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Supervisor Partition 



$.CF Partition 



Other Partitions 



EDX Common Area 
S$POOL 
CSXSYS 


EDX Common Area 
S$POOL 
CSXSYS 

Communications Facility 
control program 
($.CFS or $.CFD) 


EDX Common Area 
S$POOL 
CSXSYS 


EDX Supervisor 

Communications Facility 
language extensions 

Remote disk support 
(optional) 






Communications Facility 
message pool (CFBUF) 




Local Communications 
Controller support 
(optional) 


Communications Facility 
command processor 
transients 


Other Communications 
Facility and EDX programs 


S$CFDCBS* 






Series/ 1-to-Series/l lOCP 
($.IO0A10) (optional) 


Other programs 


Other programs 



o 



Figure 38. EDX/Communicatioiis Facility Partition Structure 



Those whose names begin with 'A.* nm as overlays of $EDXASM. They assemble 
the language extension instructions. 

Those whose names begin with *CS' are object modules that become part of the 
EDX supervisor. The section "EDX Supervisor Storage Requirements" on 
page 220 explains which ones are required. 

Those whose names begin with *$.' are load modules. The required programs are: 

• The Communications Facility control program, either $.CFS or $.CFD. 

• The initialization program, S.CFINTT. It runs in the $.CF partition in the area 
that is subsequently used for command processor transients. 

• Command processor transient programs, those whose names begin with '$.CP'. 



\^ 



This support is produced in EDX Version S.2. 
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The rest of the programs are optional. Determine which ones you will be using and 
calculate the total storage requirements. Add to this total the storage required for 
your Communications Facility application programs and other EDX programs. 
Unless you have far more storage than required, decide which programs will run in 
each partition and size the partitions accordingly. The section "Program Loading 
and Partition Use*' on page 232 explains how you can control which partition 
Communications Facility programs are loaded into. 

Figure 39 on page 216 includes the programs that run as overlays, but you can 
ignore them when you*re planning storage requirements. The size of the largest 
overlay is included in the total size of the programs that have overlays. 
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Module Name 


Function 


Size ulthout Di 


mamic Storaee 


Dynamic 
Storage Size 

(Bytes) 


Total Size 
(Bytes) 


Hex 


Dednud 


A.CFID 


Compile CFID instructions 


0200 


512 





512 


A.CFTERM' 


Compile CFTERM instructions 


0600 


1536 





1536 


A.CSXDEP 


Compile DEFINE instructions 


ODOO 


3328 





3328 


A.GETPUT' 


Compile GET, PUT, and MOV instructions 


1700 


5888 





5888 


A.SENREC' 


Compile SEND, RECEIVE, ACTIVATE, 
FREE, and LOCATE instructions 


1600 


5632 





5632 


CSA 


Global attention list 


14A 


330 





330 


CSF 


Process GET FIELD and PUT instructions 


S06 


1286 





1286 


CSM 


Process SEND and RECEIVE instructions 


DIA 


3354 





3354 


CSP 


Communications Facility parameter table 


C 


12 





12 


CSPCCINT 


PC Connect initialization 


204 


516 





516 


CSPCCIPL 


PC Connect initialization call routine 


18 


24 





24 


CSPCCOPN 


PC Connect microcode data sets open routine 


6D0 


1744 





1744 


CSPCCPTC 


PC Connect microcode patch load routine 


8C6 


2246 





2246 


CSPDIO 


Remote disk 


1248 


4680 





4680 


CSX 


Process ACTIVATE, FREE, GET, LOCATE, 
and MOV instructions 


B34 


2868 





2868 


CSX' 


Process ACTIVATE, FREE, GET, LOCATE, 
and MOV instructions 


B34 


2868 





2868 


CSXINIT 


Initialize EDX command table 


31E 


798 





798 


CSXRDINT 


Remote disk initialization 


250 


592 





592 


CSXSYS 


Communications Facility system tables 


2CC 


716 





716 


S.CFD 


Control program (disk queuing) 


2A00 


10752 


7680 


18432 


S.CFINIT 


System initialization 


OBOO 


2816 





2816 


S.CFMENU 


Sample program 


OCOO 


3072 





3072 


S.CFS 


Control program (storage queuing) 


lAOO 


6656 


7680 


14336 


S.CFSHUT 


Shut down the Communications Facility 


0600 


1536 





1536 


$.CK14E8' 


Process SNA logon responses 


0800 


2048 





2048 


$.CK14E8',' 


Process SNA logon responses 


0800 


2048 





2048 


S.CONFIG 


Configuration processor utility 


1100 


4352 





4352 


S.CPCMCF 


Process Communications Manager commands 


1300 


4864 


512 


5376 


S.CPDEF 


Process CP define commands 


1600 


5632 





5632 


S.CPDEF 


Process CP define commands 


1600 


5632 





5632 


S.CPF 


Process CP modify commands 


IDOO 


7424 





7424 


' Overlays 

' Includes the size oi 

' Includes the size oi 

* With LU-l suppor 
' Without LU-1 sup 

* Requires an additit 
'EDX Secondary SI 


* the largest overlay 

'the EDX largest overlay 

t 

port 

}nal 6144 decimal bytes in the same partition on a 

NIA2 support 


2K boundary 









Figure 39 (Part 1 of 4). Module Sizes 
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Module Name 


Fnnctfon 


Size without Dyiuunic Storage 


DyBtnic 
Storage Size 

(Bytes) 


Total Si7« 

(Bytes) 


Hex 


Dednud 


S.CPF 


Process CP modify commands 


IDOO 


7424 





7424 


S.CPFILE 


Process CP file commands 


OEOO 


3584 





3584 


S.CPH 


Process CP halt commands 


0900 


2304 





2304 


S.CPHELP 


Process CP help commands 


IBOO 


6912 





6912 


S.CPHELP' 


Process CP help commands 


ICOO 


7168 





7168 


S.CPLINK 


Process CP link commands 


0800 


2048 





2048 


S.CPP 


Process CP stop commands 


AOO 


2S60 





2560 


S.CPPD 


Process PD commands 


ICOO 


7168 





7168 


SCPO* 


Process CP query commands 


600 


1536 





5888' 


S.CPOOVl' 


Process CP query commands 


1100 


4352 





4352 


$.CP0OV2' 


Process CP query coounands 


0800 


2048 





2048 


$.CP0OV3' 


Process CP query commands 


OAOO 


2560 





2560 


$.CP0OV4' 


Process CP query commands 


0700 


1792 





1792 


$.CP0OV5' 


Process CP query commands 


1200 


4608 





4608 


$.CP0OV5' 


Process CP query commands 


1200 


4608 





4608 


S.CPREAD 


Process CP read commands 


OBOO 


2816 





2816 


S.CPS 


Process CP start commands 


2000 


8192 





8192 


S.CPS' 


Process CP start commands 


2000 


8192 





8192 


S.CPSET 


Process CP set commands 


800 


2048 





2048 


S.CPSHUT 


Shut down the Communications Facility 


0200 


512 





512 


S.CPST 


Process CP statistics commands 


lAOO 


6656 





6656 


S.CPV 


Process CP vary commands 


0700 


1792 





1792 


S.DSFORM 


Emulated PC disk management utility 


2800 


10240 





10240 


S.DSINIT 


Initialize disk queue data sets 


1700 


5888 





5888 


S.HMU 


Host management utility 


1200 


4608 


1024 


12544' 


S.HMUOVl' 


Shutdown and execute program 


OFOO 


3840 





3840 


$.HMU0V2' 


Send and receive data sets 


IBOO 


6912 





6912 


$.HMU0V3' 


Host management utility functions 


1100 


4352 





4352 


S.HSL 


High-speed loader 


0200 


512 





512 


$.IO0AA8 


PC Connect lOCP 


2700 


9984 


6144 


16128 


S.IOOABO 


Local Communications Controller lOCP 


IDOO 


7424 


6144 


13568 


S.IO0AB8 


X.25 lOCP 


6400 


25600 


5120 


30720 


' Overlays 

' Includes the size of the largest overlay 

' Includes the size of the largest EDX overlay 

* With LU-1 support 

' Without LU-1 support 

* Requires an additional 6144 decimal bytes in the same partition on a 
' EDX Secondary SNA2 support 


2K boundary 
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CompoDOit Name 


Function 


Size without Di 


fttuaic Storage 


Dymmlc 
Storage Size 

(Bytes) 


Total Size 

(Bytes) 


Hex 


Decimal 


S.IOOACX) 


3270 control lOCP 


1300 


4864 


6144 


11008 


S.IOOADO 


Channel attach lOCP 


lAOO 


6656 


6144 


12800 


S.IOOAEO 


3270 emulation lOCP 


1500 


5376 


6144 


11520 


S.IOOAIO 


Series/ l-to-Scries/l BSC lOCP 


OCOO 


2816 





2816 


$.IO0A20 


Point-to-point BSC lOCP 


OCOO 


3072 


6144 


9216 


$.IO06F0 


3101 lOCP 


5600 


22016 


5120 


27136* 


S.IO0670 


4978/4980 data stream lOCP 


2900 


10496 


6144 


16640 


$.100674 


Printer lOCP 


1900 


6400 


8192 


14592 






2000 


8192 


8192 


16384* 


$.100680 


7485 lOCP 


5800 


22528 


8960 


31488* 


$.101 4E8 


SNA lOCP 


3300 


13056 


6144 


19200* 


$.101 4E8' 


SNA lOCP 


3B00 


15104 


6144 


21248' 


$.101 CCS 


Disk-Server lOCP 


1200 


4608 


5376 


9984 


$.MIG212 


Convert 31 OIF and printer stations 


1900 


6400 





6400 


$.MIGR20 


Convert 3101 F station 


1900 


6400 





6400 


$.MIGR2ir 


Convert SNAl PU and LU sutions 


1800 


6144 





6144 


$.OPAID 


Process $.CONFIG assist commands 


0300 


768 





768' 


$.OPCH 


Process $.CONFIG change commands 


5C00 


23552 





23552 


$.0PCH' 


Process $.CONFIG change commands 


5900 


22784 





22784 


$.OPCOPY 


Process $,CONFIG copy commands 


IBOO 


6912 





6912' 


$.OPDEF 


Process $.CONFIG define commands 


6A00 


27136 





27136 


$.OPDEF 


Process $.CONFIG define commands 


6600 


26112 





26112 


$.OPDISP 


Process $.CONFIG display commands 


2700 


9984 





9984 


$.OPDISF 


Process $.CONFIG display commands 


2700 


9984 





9984 


$.OPEDIT 


Process $.CONFIG edit commands 


OFOO 


3840 





3840 


$.OPHELP 


Process $.CONFIG help commands 


0500 


1280 





1280 


$.OPLINK 


Process S.CONFIG link commands 


1000 


4096 





4096 


$.OPLIST 


Process $.CONFIG list commands 


2B00 


11008 





11008 


$.OPLIS'r 


Process $.CONFIG list commands 


2C00 


11264 





11264 


$.OPSETX 


Process $.CONFIG set exit commands 


0400 


1024 





1024' 


$.PANEL 


Pane! design aid 


4D00 


19712 


512 


20224 


$.PD 


Program dispatcher 


2A00 


10752 


1280 


12032 


$.PDBSTS 


Volume protection utility 


0900 


2304 





2304 


' Overlays 

* Includes the size of the largest overlay 

' Includes the size of the largest EDX overlay 

* With LU-1 support 

' Without LU-1 support 

* Requires an additional 6144 decimal bytes in the same partition on a 
' EDX Secondary SNA2 support 


2K boundary 
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Component Name 


Function 


Size widiottt Dywunk Storase 


Dynamic 
Storage Size 

(Bytes) 


Total Size 

(Bytes) 


Hex 


Decimnl 


S.PDHELP 


Display PD commands 


1200 


4608 





4608 


S.PDINIT 


Program dispatcher initialization 


1900 


6400 





12032* 


S.PDINPF' 


Preflnd transaction-processing programs 


1600 


5632 





5632 


J.PDIPL 


Remote IPL 


2600 


11264 





11264 


$.PDSCHD 


Schedule transactions 


0700 


1792 


256 


2048 


$.PD<IO> 


Remote disk I/O 


500 


1280 





1280 


S.PNLPRT 


Print panel description for $.PANEL 


2100 


8448 





8448 


$.PNLUT1 


Panel utility 


lEOO 


7680 


2560 


10240 


$.PR14E8' 


Send SNA logon prompts 


0700 


1792 





1792 


S-PRMES',' 


Send SNA logon prompts 


0700 


1792 





1792 


S.RMU 


Remote management utility 


1000 


4096 


1024 


10496' 


$.SETSTG 


Modify storage for message buffer 


ODOO 


3328 





3328 


S.UTl 


Diagnostic aid utility 


1200 


4608 





4608 


$.UT2 


Report and purge messages 


2100 


8448 


512 


8904 


$.UT2DS 


Open disk queues for $.UT2 


OFOO 


3840 





3840 


$.WSC 


Work session controller 


2800 


10240 


2304 


12544 


S.WSCUTl 


Catalog work session controller images 


3B00 


15104 





15104 


S.WSMENU 


Work session controller sample program 


OBOO 


2816 





2816 


' Overlays 

' Includes the size of the largest overlay 

' Includes the size of the largest EDX overlay 

* With LU-1 support 

' Without LU-1 support 

* Requires an additional 6144 decimal bytes in the same partition on a 
' EDX Secondary SNA2 support 


2K boundary 
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Communications Facility Working Storage 



The Communications Facility has various working storage areas whose size you 
should adjust to suit your requirements. 

Most of these areas are dynamic storage, as defined by the STORAGE operand of 
PROGRAM statements. The size of these areas, as distributed, is shown in 
Figure 39 on page 216. Use the SS command of the EDX utility $DISKUT2 to 
set the sizes you need. The storage requirements are explained later in this chapter. 

Some of the storage areas are workspace pools ^ areas that include information used 
to control the allocation of space from the pool. Each pool has an 8-byte buffer 
reference block (BRB). Each element in the pool has an 8-byte storage resource 
block (SRB). The length of each element is a multiple of 8 bytes. An element can 
be a work area or a buffer. Each buffer has a 10-byte buffer header. 
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When you calculate the size of a pool, you must allow for this overhead. Suppose, 
for example, you need a pool large enough for three 2500-byte buffers. The space 
required for each buffer is 2520 bytes (2500 plus 8 for the SRB and 10 for the 
buffer header, rounded to a multiple of 8). The required pool size is 7568 bytes (3 
times 2520, plus 8 for the BRB). If the pool is in dynamic storage, its size is 7680 
bytes (7568 rounded to a multiple of 256). 



EDX Supervisor Storage Requirements 



The chapter ''Installing the Communications Facility" on page 251 explains which 
EDX modules and hardware definition statements are required to support the 
various types of Communications Facility stations. Refer to the EDX Installation 
and System Generation Guide for information about estimating the size of an EDX 
supervisor. Add the storage required for the Communications Facility, as follows, 
using the module sizes shown in Figure 39 on page 216. All Communications 
Facility supervisor components must reside in partition 1 or the EDX COMBASE 
partition. 

Modules CSA, CSP, CSF, CSM, CSX, and CSXINTT are required as follows: 
CSA, CSP and CSXINTT reside in partition 1 ; modules CSF, CSM and CSX reside 
in the EDX COMBASE partition. 

Module CSXSYS, the system storage pool (CSXPOOL) and the DCB pool 
(CSXDCBS) are required as follows: The DCB pool must reside in partition 1 ; ,^ 

CSXSYS and CSXPOOL are part of the common area (described under "Common (^/ 

Area Storage Requirements"). 

Modules CSPDIO and CSXRDINT are required for remote disk support in nodes 
that access disks attached to remote nodes. CSPDIO must reside in partition 1, in 
the static section of the supervisor. 

Each multifunction attachment 3101 or 7485 that is defined to the 
Communications Facility but not to EDX (each CFTERM instruction) requires 4 
bytes. 



Common Area Storage Requirements 



The common area is that part of the supervisor that may be mapped into other 
partitions. It must be mapped into all partitions in which Communications Facility 
programs, including user application programs, are executed. The maximum 
partition size available for Communications Facility programs in partition 1 is 64K 
minus the size of the supervisor. In all other partitions into which the common area 
is mapped, the maximum partition size available is 64K minus the size of the 
common area rounded to a multiple of 2K. For example, if the size of the common 
area is 5K, then the maximum partition size available for Communications Facility 
programs is 58K (64K minus 6K). 
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Components of the Common Area 



The common area must include S$POOL (system pool storage) and module 
CSXSYS (Communications Facility system tables). If you choose to base the EDX 
common area in partition 1, it will also contain EDXSYS (EDX system tables). It 
can also include other common data ($SYSCOM) required for your instaUation, as 
described in the EDX Installation and System Generation Guide. Unless you base 
the common area in partition 1, your application programs may not assume that 
EDXSYS is in the common area, nor that S$POOL elements reside in partition 1. 

The size of EDXSYS is approximately 1400 bytes. It is different for different 
releases of EDX. Look at an EDX supervisor link-edit map to determine its exact 
size. The size of CSXSYS is given in Figure 39 on page 216. The sizes of 
S$POOL and S$CFDCBS are discussed under "S$POOL Storage Requirements" 
on page 221 and ''S$CFDCBS Storage Requirements" on page 222. 

Once you have estimated the size of S$POOL and the common area, you may want 
to increase the size of S$POOL so that the common area is a multiple of 2K. For 
example, your initial calculation of the common area size may be: 

Element Bytes 



EDXSYS 


1382 


CSXSYS 


560 


S$POOLBRB 


8 


S$POOL 


4000 



Total 5958 

This leaves 186 bytes of unused common area (6144 minus 5958). If you are not 
certain that the size of S$POOL is adequate for your requirements, increase it to 
4184 (a multiple of 8). This will increase the size of the supervisor by 184 bytes, 
but will not affect the amount of storage available for Communications Facility 
programs in other partitions. 

After you have installed the Communications Facility, look at the EDX link-edit 
map to check that the size of the common area is what you intended. Entry point 
CSXEND shows the size. 



S$POOL Storage Requirements 



During the installation procedure, you will define the system storage pool, 
S$POOL. The Communications Facility uses S$POOL for station control blocks, 
the high-speed loader, and work areas. 
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To calculate the size of S$POOL, add the sizes of the elements you require, using 
the following values. Each value includes 8 bytes for the SRB. 

S$POOL Element Bytes 

Message dispatcher station ($.DISP) 104 

Each CA, CPU, LCC, PCC, FTPT, 3271C or 3271E line 264 

station 

Each DCE or DTE line station 112 

Each circuit station 128 

Each terminal or node station 88 

Each volume station 104 

Each 4978 or printer device station 264 

Each 3 lOlF device station 160 

Each user or message station 88 

Each alias station 40 

SNA physical unit station 128 

Each EDX Secondary SNA 1 logical unit station 280 

Each EDX Secondary SNA2 logical unit station 120 

Each remote (vector) station 32 

Each work session controller terminal station 392^^ 
Program dispatcher space requirements: 

Program dispatcher station ($.PD) 88 

High-speed loader ($.HSL) 520 

Each transaction-processing station 88 

Remote disk support station ($.PD>IO<) 88 
$.100670 work areas 

(one for every three or four active 4978s/4980s) 56 

If your application programs will use work areas in S$POOL, add the space they 
require. If your use of S$POOL is volatile (that is, stations of different sizes are 
active at different times), allow some extra space for fragmentation. 

When the Communications Facility is running, you can use the DQ command of 
the diagnostic aid utility ($.UT1) to monitor the usage of S$POOL. The command 
displays information about each element in the pool, including free space. $.UT1 is 
described in the Operator's Guide. 



S$CFDCBS Storage Requirements 



During the installation procedure, you will define the DCB pool, S$CFDCBS, and 
include it in partition 1. The Communications Facility uses S$CFDCBS to hold 
one DCB for each device station it manages without the use of EDX-provided I/O 
facilities (for example, device 3101F stations). It also holds executable code to 
invoke Communications Facility interrupt handling routines. 

To calculate the size of S$CFDCBS, allow 72 bytes for each 3101F device station 
you define in your Communications Facility configuration. This value includes 8 
bytes for the SRB. Add another 8 bytes for the BRB. 

If your application programs manage devices that require a DCB and they do not 
use EDX-provided I/O facilities, you may want to include space in S$CFDCBS for 
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your application DCBs and interrupt handler calls. The Series/ 1 assembler OIO 
and lO instructions are not EDX-provided I/O facilities. 



$.CF Partition Storage Requirements 



The $.CF partition must be large enough to contain: 

The common area 

The control program ($.CFS or $.CFD) 

The message birff er pool 

Command processor transients 

Optionally, the Series/ 1-to-Series/l lOCP ($.IO0A10). 

Each command processor program is a transient program — ^it is loaded by the 
control program, processes one command, and terminates. The space required is 
6912 bytes, which is the size of the start command processor. You can run other 
programs in the $.CF partition, but you must be careful not to use up the space 
required for the command processor. 



Message Buffer Pool (CFBUF) Requirements 



O 



The message buffer pool is the dynamic storage of module $.CFS or $.CFD. It 
contains storage-queued messages that have been sent but not yet received. To 
estimate how much space is required, you need to consider the size of messages, 
whether or not messages are queued on disk, and how long messages remain in the 
pool. 

If you use the Series/ 1-to-Series/l lOCP ($.IO0A10), add the space required for 
its line buffer as explained in the section "lOCP Buffer Requirements" on 
page 223. 

If your system includes disk queuing of messages, add the space required for file 
control blocks (FCBs). An FCB contains information about a station that has a 
disk queue. Its size, including the SRB, is 48 bytes. $.CFD splits its dynamic 
storage into two pools, the message buffer pool and a pool for FCBs. As 



^1 



Planning Storage Requirements 222. 1 



o 



© 



C) 



^ 



222.2 Communications Fadlity Design and Installation Guide 






distributed, it allows space for ten FCBs. Use utility program $.SETSTG, 
described in the Operator's Guide, to alter the size of either pool. 

If your system does not include disk queuing of messages, use the EDX utility 
$DISKUT2 to set $.CFS's dynamic storage to the size you require for the message 
buffer pool. 

Performance is degraded if the message buffer pool is too small, because 
Communications Facility programs that send messages wait until space is available 
if the pool is full. When the Communications Facility is running, you can use the 
CP Q CFBUF command to monitor usage of the message buffer pool and to set a 
warning level. You can also monitor usage of the message buffer pool with the DB 
command of the diagnostic aid utility ($.UT1). The command displays information 
about each element in the pool, including free space. The free space displayed is 
not the total free space. Since fragmentation of storage may occur, this cannot be 
used as a reliable indicator of remaining space. $.UT1 and the CP commands are 
described in the Operator's Guide. 



lOCP Buffer Requirements 






o 



Each lOCP has a buffer pool from which it obtains buffers to process messages for 
the stations that it manages. This section explains how to determine the buffer size 
required for stations and the buffer pool size required for each lOCP. 

You specify the buffer size for a device, line, or SNA physical unit station when 
you define it to the Communications Facility, using either the CP Define command 
or the $. CONFIG utility program. The size required varies according to the station 
type, as described in the following sections. 

The buffer pools are, in most cases, the dynamic storage of the lOCPs. Figure 39 
on page 216 shows their sizes, as distributed. When you calculate the size of a 
buffer pool, remember to allow space for the BRB, SRBs, and buffer headers, as 
explained under "Communications Facility Working Storage" on page 219. The 
buffer and work area sizes given in this section don't include the SRB or buffer 
header. 

$.IO0AA8, PC Connect 

When planning $.IO0AA8's storage requirements, consider these three factors: 

• The amount of dynamic storage. 

• The amount of mapped storage required by the lOCP to perform the host 
connection function. 

• The amount of available mapped or unmapped processor storage for the host 
connection message buffers. 

First, $.IO0AA8 uses its dynamic storage as its buffer pool. It requires a 578-byte 
work area and a line buffer to receive messages from the PC Connect for each 
active line. The size of the line buffer required is 20 bytes plus the buffer size 
specified for the PCC line station. The lOCP acquires the work area and the 
buffer when a line station is started and releases them when the station is stopped 
or halted. 
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$.100 AA8 also requires a second line buffer to transmit messages. It acquires this 
transmit buffer when the need arises and releases it after the operation is 
completed. The lOCP requires space in its buffer pool for only one transmit 
buffer, even when it manages multiple lines. For improved performance, you 
should allow space for a transmit buffer for each active line. 

The line buffer must be as large as the largest message transmitted between the 
Series/ 1 and any gateway PC connected to the Series/ 1. Allow 20 bytes for the 
message header. The buffer size for the Series/ 1 and the gateway PC 
communicating with each other should be the same. If the buffer size is not the 
same, the smaller size governs the amount of data that can be exchanged. The 
gateway PC buffer size is 33170 bytes (8192 hexadecimal). 

When performing host connection function, $.IO0AA8 also acquires an 1 8-byte 
segmentation register table entry for each 2K of mapped or unmapped storage 
obtained. This 1 8-byte table entry contains the segmentation register value and 
other information associated with the 2K of mapped or unmapped storage. It is 
acquired or released at the same time as the 2K of mapped or unmapped storage. 

Next, $.IO0AA8 requires a 2K block of mapped storage in the same partition as 
the lOCP. This block of storage is obtained when performing host connection 
function, and is released when the function is complete. 

Finally, $.IO0AA8 keeps a message buffer in 2K of mapped or unmapped storage 
for each PC communicating with the host. This storage is acquired when the first 
segment message is sent from the PC to the host. It is released when the last 
segment message is sent. 

The number of available 2K blocks of mapped or unmapped storage in your system 
must be equal to or greater than the number of PCs communicating with the host at 
the same time. The number of available unmapped storage blocks is reported by 
the system when you IPL. Assuming no other program in the system uses 
unmapped storage, this number may be sufficient for communicating with the host. 
If 2K blocks of unmapped storage is insufficient, the lOCP will try to obtain 
mapped storage starting in the highest partition. It will not obtain mapped storage 
in the same partition as $.CFS (or $.CFD). 

The number of available mapped storage blocks is based on the amount of physical 
storage, the number of programs executing and their use of storage. 

The maximum number of available mapped storage blocks is controlled by the 
MAXPROG value on the EDX SYSTEM statement. See the EDX Installation and 
System Generation Guide, for an explanation of the SYSTEM statement. If the 
MAXPROG value is insufficient, increase it so that more entries are available in 
the partition you choose. 



$.IO0AB0, Local Communications Controller 



The line buffer must be as large as the largest message transmitted between the 
local node and any remote node on the ring. Allow 20 bytes for the message 
header. Nodes that communicate with each other should have line buffers of the 
same size. When they don't, the smaller size governs the amount of data they can 
exchange. 






224 Communications Facility Design and Installation Guide 



$.IO0AB8, X.25 






When message traffic between two nodes is heavy, you can improve performance 
by defining line buffers large enough to hold several messages. $JO0AB0 blocks 
messages when it can; it transmits messages when either the buffer is full or there 
are no more messages on a node station's queue. 

$.100 ABO uses its dynamic storage as its buffer pool. It requires a Une buffer, 
which is used to receive messages from the ring, and a 642-byte work area for each 
active line. The lOCP acquires the buffer and work area when a line station is 
started, and releases them when the station is stopped or halted. 

$.100 ABO also requires a second line buffer, which it uses to transmit messages. It 
acquires this transmit buffer when the need arises and releases it when the 
operation is complete. The lOCP requires space in its buffer pool for only one 
transmit buffer, even when it manages multiple lines. For optimum performance, 
you should allow space for a transmit buffer for each active Une. 

You can also allow additional space to be used for recovery from errors. If a block 
of messages cannot be sent to a remote mode, the lOCP must save the block so 
that it can continue sending messages to other nodes attached to the Local 
Communications Controller. It does this only if there is enough space in the pool 
for an additional buffer for saving the block. If there isn't, it discards the block and 
logs message I047, warning that messages may have been lost. 



$.IO0AB8 uses the line buffer size to acquire read and write buffers for DTE and 
DCE lines. The line buffer must be as large as the largest message sent or received 
by any circuit on the line. Allow additional bytes for the Communications 
FaciUty/X.25 data or control message headers. At present, these headers are 2 
bytes long. If any circuits on the line have a usage type of CF, allow another 24 
bytes for the Communications Facility message header. 

When the line buffer size is larger than the line packet size, messages can be sent 
and received that are several packets long. The line's read task must wait for all 
packets in the message to arrive before another read can be issued. The arrival of a 
complete packet sequence can be delayed indefinitely because Recommendation 
X.25 does not specify a maximum time delay between packets in a sequence. This 
means the line's read task should wait indefinitely. For this reason, the line buffer 
size equal the line packet size when possible. 

$.IO0AB8 uses its dynamic storage as a buffer pool and as a storage pool for 
station work areas. It requires a read buffer and a 1240-byte work area for each 
active line station. It requires a 304-byte work area for each active circuit station. 
This storage is acquired when the station is started and released when the station is 
stopped or halted. 

$.IO0AB8 uses the rest of its storage area more dynamically. It acquires a write 
buffer to receive a message from a circuit station's queue and releases the buffer 
when the message is successfully written to XHCS. If the message is an X.25 
control message, it frees the buffer when the XHCS control instruction completes 
successfully and the confirmation control message is sent back to the originating 
station, if required. The lOCP acquires a temporary 304-byte work area to open a 
circuit and releases the storage when the open has successfully completed. If 
message traffic is heavy on all the line's circuits, allow space for one Une buffer per 
circuit. Otherwise, fewer Une buffers are needed. 
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To reduce fragmentation of its dynamic storage area, $.100 AB8 acquires storage in 
multiples of 312 bytes, including the SRB and buffer header. When you calculate 
how much space to aUow for read and write buffers, add 18 bytes to the line buffer 
size for the SRB and buffer headers, and round the result to a multiple of 3 12. 
$.IO0AB8 only uses the line buffer size portion of the storage, even if more is 
acquired. 



$.IO0AC0, 3270 Control Line 



For 3270 control, the line buffer must be as large as the largest message for any of 
the terminal stations associated with the line. Allow 13 bytes for BSC and 3270 
control data that may be appended to a message. 

$.IO0AC0 uses its dynamic storage as its buffer pool. It acquires a line buffer to 
receive input from a terminal and releases the buffer when the operation is 
complete. It acquires a line buffer to send output to a terminal and releases the 
buffer when there is no more pending output for that terminal. 

The lOCP requires space in its buffer pool for only one line buffer, even when it 
manages multiple lines. However, for optimal performance, you should allow space 
for one Une buffer for each active Une, especially when a line is used for 
communication between Series/ Is. During communication between Series/ Is, 
many messages may accumulate on a terminal's queue, and space in the buffer pool 
is not released until all the messages are sent. If you have multiple Unes with 
different buffer sizes, you should allow extra space in the buffer pool for 
fragmentation. 



$.IO0AD0, Channel Attach 



For channel attach, the Une buffer must be as large as the largest message for any 
of the terminal stations (ports) associated with the Une. Allow 4 bytes for BSC 
control characters that may be appended to a message. 

$.IO0AD0 uses its dynamic storage as its buffer pool. It requires a line buffer and 
a 300-byte work area for each active line. It acquires the buffer and work area 
when a Une station is started, and releases them when the Une station is stopped or 
halted. 



$.IO0AE0, 3270 Emulation Line 



For 3270 emulation, the Une buffer must be as large as the largest message for any 
of the terminal stations associated with the line. AUow 7 bytes for BSC and 3270 
control characters 4hat may be appended to a message. 

$.IO0AE0 uses its dynamic storage as its buffer pool. It acquires a Une buffer to 
receive a message from the host and releases the buffer when the operation is 
complete. It acquires a Une buffer to send messages to the host and releases the 
buffer when there is no more pending output from any terminal. 

The lOCP requires space in its buffer pool for only one Une buffer, even when it 
manages multiple lines. However, for optimal performance, aUow space for one 
Une buffer for each active line. If you do not, you wUl probably get time-outs when 
poUed by the host. It is especiaUy important that you aUow space for one buffer 
per line when the line is used for communication between Series/ Is or to transfer 
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large messages to a host. In these cases, many messages may accumulate on the 
terminals' queues, and space m the buffer pool is not released until all the messages 
are sent. If you have multiple lines with different buffer sizes, you should allow 
extra space in the buffer pool for fragmentation. 



$.IO0A10, Series/l-to-Series/1 line 



For Series/ 1-to-Series/l, the line buffer must be as large as the largest message 
transmitted between the two Series/ Is, including 24 bytes for the message header. 

$.IO0A10 does not have its own buffer pool. It uses the message buffer pool, 
CFBUF. It requires a line buffer for each active line. It acquires the line buffer 
when a line station is started, and releases the buffer when the line station is 
stopped or halted. 



\>' 



$.IO0A20, Point-to-Point line 

For a point-to-point line, the line buffer must be as large as the largest message 
transmitted between the Series/ 1 and the system to which it is connected. Allow 2 
bytes for BSC control characters that may be appended to a message. 

$.IO0A20 uses its dynamic storage as its buffer pool. It requires two line buffers 
for each active line. It acquires the buffers when a line station is started, and 
releases them when it is stopped or halted. 

$.IO06F0, 3101 Device 

When planning $.IO06F0's storage requirements, consider these three factors: 

• The amount of mapped storage required by the lOCP itself regardless of the 
number of supported devices. 

• The amount of dynamic storage. 

• The amount of available mapped and/or unmapped processor storage for 
screen image workspaces. 

First, $.IO06F0 requires a 6K block of mapped storage in the same partition as the 
lOCP. This block of storage creates the window to view device screen images in 
unmapped (or other mapped) storage. 

Next, $.ICX)6F0 uses its dynamic storage as a pool to obtain a 232-byte work area 
for a task control block (TCB) and workspace for each started station. The work 
area is obtained when the station is started and is not released until the lOCP is 
halted. As shipped, $.ICX)6F0's dynamic storage area is 5120 bytes, which 
supports 16 3101s. To support more than 16 3101s, increase the dynamic storage 
of $.IO06F0 and, if necessary, provide more mapped storage entries as described 
below. 

$.IO06F0 also acquires a 220-byte work area from its dynamic storage, if space is 
available, during output to a device. If no space is available, it can perform output 
to only one device at a time. For optimum performance, you should aUow space 
for one of these work areas for every three to five devices. 
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Finally, $.IO06F0 keeps a screen image workspace in mapped and/or unmapped 
storage for each device. The size of the screen image workspace depends on the 
maximmn number of fields on any screen image sent to the device. The size of the 
workspace must be 1990 bytes plus 2 bytes per field. In an unprotected field, two 
consecutive unprotected fields separated by one or more spaces are counted as 
three fields. The minimum size is 2048 bytes, which allows for 29 fields. The 
largest size you ever need specify is 3910 bytes, which allows for 960 fields. 
Estimate the amount of storage required by adding the screen image sizes for each 
active station. Divide the sum by 2K and subtract two to get the number of 2K 
blocks of of unmapped and/or mapped storage required to satisfy your screen 
image workspace requirements. (Approximately two workspaces will be obtained 
from the original 6K block.) 

The number of available 2K blocks of unmapped and/or mapped storage in your 
system must be equal to or greater than the screen image workspace requirement to 
start all the devices concurrently. The number of available unmapped storage 
blocks is reported by the system as part of the IPL messages. Assuming no other 
program in the system uses unmapped storage, this number may be sufficient. If 
this number is insufficient, the lOCP will try to obtain mapped storage starting in 
the highest partition. It will not obtain mapped storage in the same partition as 
$.CFS (or $.CFD). 

The number of available mapped storage blocks is based on the amount of physical 
storage, the number of currently executing programs and their storage usage. 

The maximum number of available mapped storage blocks is controlled by the 
MAXPROG value on the EDX SYSTEM statement. (See the EDX Installation 
and System Generation Guide, for an explanation of the SYSTEM statement.) If 
the value on MAXPROG is insufficient, increase it so that more entries are 
available in the partition you choose. 

Each of these lOCPs also has a 3100-byte buffer, defined in module S$IO0634, 
which is shared by all active devices. This buffer must be as large as the largest 
message sent to a device. If you need to change the size of this buffer, modify and 
assemble S$IO0634 and link it with the other modules that form the lOCP. 



o 



$.100670, 4978/4980 Data Stream Devices 



For the 4978/4980 data stream lOCP, the device buffer must be as large as the 
largest message sent to or received from the device. The minimum size allowed is 
2048 bytes. 

$.100670 uses its dynamic storage as its buffer pool. The space in the pool is 
shared by aU active devices. Allow space for one device buffer for every three or 
four active devices. 

$.100670 also acquires a 176-byte work area from dynamic storage as each device 
station is started. This area is used for the device TCB and work area, and is 
released when the device station is stopped or halted. Allow one work area for 
each active device station. 

$.100670 also uses the system storage pool, S$POOL. It acquires a 48-byte work 
area to process a message. Allow space for the same number of work areas as 
device buffers in the dynamic storage pool. 
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^ $.100674, Printer Dences 



For the printer lOCP, the device buffer must be as large as the largest message sent 
to the printer. The minimum size allowed is 2048 bytes. 

$.100674 uses its dynamic storage as its buffer pool. It acquires two buffers from 
the pool to process a message — a device buffer and a work buffer. For 3270 mode 
printer stations, the work buffer is 2054 bytes. For SCS mode printer stations, the 
work buffer size is the device buffer size plus 134 bytes. If you have only one 
printer station, allow space in the pool for one of each of these buffers. If you have 
more than one printer station and they are very busy, allow space for one 
2054-byte buffer per printer and two device buffers. The device buffer size is 
specified when the printer device station is defined. 

$.100674 also requires a 40-byte work area for each active printer station in SCS 
mode. It acquires the work area from the dynamic storage pool when the station is 
started and releases it when the station is stopped or halted. 

$.100680, 7485 Devices 

When planning $.IO0680's storage requirements, consider these three factors: 

• The amount of mapped storage required by the lOCP itself regardless of the 
number of supported devices. 

• The amount of dynamic storage. 

• The amount of available mapped and/or unmapped processor storage for 
screen image workspaces. 

First, $.100680 requires a 6K block of mapped storage in the same partition as the 
lOCP. This block of storage creates the window to view device screen images in 
unmapped (or other mapped) storage. 

Next, $.100680 uses its dynamic storage as a pool to obtain a 232-byte work area 
for a task control block (TCB) and workspace for each started station. The work 
area is obtained when the station is started and is not released until the lOCP is 
halted. As shipped, $.IO0680's dynamic storage area is 5632 bytes, which supports 
16 7485s. To support more than 16 7485s, increase the dynamic storage of 
$.100680 and, if necessary, provide more mapped storage entries as described 
below. 

$.100680 also acquires a 356-byte work area from its dynamic storage, if space is 
available, during output to a device. If no space is available, it can perform output 
to only one device at a time. For optimum performance, you should allow space 
for one of these work areas for every three to five devices. 

Finally, $.ICX)680 keeps a screen image workspace in mapped and/or unmapped 
storage for each device. The size of the screen image workspace depends on the 
maximum number of fields on any screen image sent to the device. The size of the 
workspace must be 1990 bytes plus 2 bytes per field. In an unprotected field, two 
consecutive unprotected fields separated by one or more space is counted as three 
fields. The minimum size is 2048 bytes, which allows for 29 fields. The largest 
size you ever need specify is 3910 bytes, which allows for 960 fields. Estimate the 
amount of storage required by adding the screen image sizes for each active station. 
Divide the sum by 2K and subtract two to get the number of 2K blocks of 
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unmapped and/or mapped storage inquired to satisfy your screen image workspace 
requirements. (Approximately two workspaces will be obtained from the original 
6K block.) 

The number of available 2K blocks of immapped and/or mapped storage in your 
system must be equal to or greater than the screen image workspace requirement to 
start aU the devices concurrently. The number of available unmapped storage 
blocks is reported by the system as part of the IPL messages. Assuming no other 
program in the system uses unmapped storage, this number may be sufficient. If 
this number is insufficient, the lOCP will try to obtain mapped storage starting in 
the highest partition. It will not obtain mapped storage in the same partition as 
$.CFS (or $.CFD). 

The number of available mapped storage blocks is based on the amount of physical 
storage, the number of currently executing programs and their storage usage. 

The maximum number of available mapped storage blocks is controlled by the 
MAXPROG value on the EDX SYSTEM statement. (See the EDX Installation 
and System Generation Guide, for an explanation of the SYSTEM statement.) If 
the value on MAXPROG is insufficient, increase it so that more entries are 
available in the partition you choose. 

Each of these lOCPs also has a 3100-byte buffer, defined in module S$IO0634, 
which is shared by aU active devices. Hiis buffer must be as large as the largest 
message sent to a device. If you need to change the size of this buffer, modify and 
assemble S$IO0634 and link it with the other modules that form the lOCP. 



$.I01CC8, PC Connect Disk-Server 



$.101 CCS uses its dynamic storage as a buffer pool. Each volume station requires 
a buffer pool large enough to contain the following: 

• 4106 bytes for the send/receive buffer 

• 416 bytes for the directory table 

• 230 bytes for the task control block and the work area 

• 74 bytes data set control block (DSCB) for each emulated PC disk. 

$.I01CC8's dynamic storage, as distributed, can support a volume station with five 
emulated PC disks. When you calculate the size of a buffer pool, remember to 
allow space for a BRB and an SRB for each element. 



$J014£8, SNA Connection 






The SNA physical unit buffer must be as large as the largest message for any of the 
SNA LU stations it controls. Allow 4 bytes for BSC control characters that may be 
appended to a message. 

$.I014E8 splits its dynamic storage into two pools. One pool is used during 

session starts and is 1 120 bytes large. The remaining space is an I/O pool shared 

by all active SNA LU stations. Each LU acquires and releases buffers from this 

I/O pool. The buffer size each LU station uses for I/O is the buffer size you (fl) 

define for its controlling PU station. Allow space for one I/O buffer for every 

three or four active SNA LU stations. 



230 Communications Facility Desien and Installation Guide 







TNL SN23-8600 (27 March 1987) to SL23-0104-2 



For the EDX Secondary SNA2 support of the $.I014E8 lOCP, each active LU 
station requires a 176-byte workspace for its TCB and work area. This workspace 
is acquired from the I/O pool when the LU station is started and is used imtil the 
station is stopped. 



© 
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Other Dynamic Storage Requirements 



This section describes the dynamic storage requirements of Communications 
Facility programs other than the control program and lOCPs. It explains what the 
dynamic storage is used for and why you may need to alter its size. The dynamic 
storage sizes, as distributed, are shown in Figure 39 on page 216. 



$.CPCMCF, Communications Manager Command Processor 



This program uses dynamic storage for responses to a Communications Manager 
DISPLAY command. The dynamic storage, as distributed, is 512 bytes; there is no 
reason to make it larger. 






$.HMU and $.RMU, Remote Management Utilities 

These programs use dynamic storage as a buffer for messages exchanged between 
the host and remote cells. The maximum message size is the smallest of $.HMU 
dynamic storage, $.RMU dynamic storage, and the $.PD transaction buffer in each 
cell. For data transfer operations, records are blocked if the maximum size allows 
it. See the discussion of record blocking and buffer size in the Remote 
Management Utility section of the EDX Communications Guide. 

$.PANEL, Panel Design Aid 

This program uses dynamic storage for work areas — one 1 16-byte area for each 
active user of the program. As distributed, the program can communicate with four 
y users at a time. 



$.PNLUT1, Panel Utility 



This program uses dynamic storage as a panel buffer. The storage required is the 
size of the largest panel to be processed, plus 10 bytes. As distributed, the program 
can process 9-record panels. 



$.PD, Program Dispatcher 



The program dispatcher uses dynamic storage for some common data, the path 
table, the transaction table, a work buffer, and a transaction buffer. The common 
data requires 16 bytes. The path table requires 24 bytes per entry, including 
reserved entries, plus 2 bytes for an end-of -table entry. The transaction table 
requires 48 bytes per entry, including reserved entries, plus 2 bytes for an 
end-of -table entry. The remaining dynamic storage is the work buffer, and must be 
at least 410 bytes. The transaction buffer overlays part of the work buffer, and is 
approximately 100 bytes smaller. 

The size of the transaction buffer governs the maximum size of a transaction that 
the program dispatcher can send or receive. The size appears as the XCODE field 
of message PDOl, which is logged when the program dispatcher is started. The CP 
Q PARM command also displays this size, in the WORK column of the line for 
$.PD. 
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Here is an example calculation, using 1280 bytes of dynamic storage (as 
distributed), three path definitions, and six transaction definitions: 



Common data 


16 


Path table 


74 


Transaction 


290 


table 





Total 380 

Work buffer = 1280 - 380 = 900 bytes 

Transaction buffer = approximately 800 bytes 



$.PDSCHD, Transaction Scheduler 



The transaction scheduler uses dynamic storage for information about transactions 
scheduled for later execution. The storage required is 32 bytes per entry. As 
distributed, the program can manage eight scheduled transactions. 



$.UT2, Disk-Queued Message Utility 



This program uses dynamic storage as a message buffer. A message larger than 
dynamic storage can be reported or purged, but it cannot be sent on. 



$.WSC, Work Session ControUer 



The work session controller uses dynamic storage for a 207 6 -byte transaction 
buffer and a 132-byte work buffer. The minimum size, and the size as distributed, 
is 2304 bytes. There is no reason to make it larger. 



Program Loading and Partition Use 



CP Start Command 



The Communications Facility manages the loading of system programs and user 
application programs. Several facilities are available for performing the load 
function: the command processor start command, the program dispatcher 
high-speed loader, and the EDX $L command. 



A system or user application program is loaded when a CP Start command for a 
user station is issued. 

An lOCP is loaded when the first CP Start command for a station managed by that 
program is issued. 
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The Start command processor uses the EDX transient loader ($LOADER) to load 
programs. When no partition is specified on the CP Start command, the Start 
command processor attempts to load programs as follows: 

1. First it attempts to load the program into the partition just below the $.CF 
partition. If that fails or the partition is not mapped, 

2. It attempts to load the program into any mapped partition, starting with 
partition 1. If that fails, 

3. It logs an error message and does not start the station. 

This process does not necessarily result in the most efficient use of partition 
storage. If you want more control over which programs are loaded into which 
partitions, several alternatives are available: 

• Specify the mapped partition into which the program is to be loaded on the CP 
Start command. The Start command processor attempts to load the program 
into the specified partition. If that fails or if the partition is not mapped, it 
attempts to load the program into any mapped partition, starting with partition 
1. 

• Start an lOCP yourself, instead of letting it be loaded when you start a station 
of the type it manages. Define the lOCP as a user station and issue a Start 
command for it, specifying the mapped partition into which it is to be loaded. 

• Start your stations in a planned sequence, so that the smallest program is 
loaded into a partition first, leaving room for $LOADER to load larger 
programs. For example, assume the remaining space in the partition just below 
the $.CF partition is 16K. Two stations need to be started. One is a 4K user 
program (smaller than $LOADER). The other is a 4978 device, which causes 
the $.100670 lOCP to be loaded. This lOCP is approximately 12K in size. If 
the 4978 is started first by a CP Start command, only 4K is left in that 
partition, which is not enough for $LOADER. But if the user station is started 
first, there is enough storage left for $LOADER to load the lOCP when the 
4978 device is started. 

If a program must run in an EDX static partition, you have two alternatives: 

• You can specify S as the partition number. The start command processor 
attempts to load the program using the normal algorithm with the additional 
constraint that the partition must be static. 

• You can specify the static partition into which you want to load your program. 

It is important to note that the start command processor automatically loads the 
lOCPs which require static partitions ($.IO0AD0, $.100680, and $.IO06F0), into 
static partitions. 
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Program Dispatcher 



The program dispatcher uses two methods to load transaction-processing programs: 

1 . It uses the CP Start command if the transaction-processing program is defined 
as a station in $.SYSNET. If the station type is user, loading is under control 
of the CP Start command processor, as already described. 

2. Otherwise, it uses the high-speed loader ($.HSL). 

You can specify in the transaction definition statement that the program is to be 
loaded into: 



f 



A specific mapped partition 

Any mapped partition except a specific partition 

The $.CF partition 

Any mapped partition except the $,CF partition 

Any mapped partition (the default) 



EDX $L Command 



The program dispatcher vahdates specified partitions when it builds its transaction 
table during initiaUzation. If a specified partition does not exist or is not mapped, 
the specification is changed to any mapped partition. 

Be careful about specifying the $.CF partition or "any partition" for programs that 
will be loaded by the high-speed loader. The programs may use up the space in the 
$.CF partition that is required for command processor transients. 



You can use the $L command to load some Communications Facility programs into 
the mapped partition you want. Most of the programs create their own station 
block during initialization if it doesn't already exist. Those that don't create their 
own station block terminate with an error message when you try to load them. 
Don't use this method when you have assigned a disk queue to a program's user 
station. It is the CP Start command processor that opens a station's disk queue. 

If you load a Communications Facihty program into an unmapped partition, a 
program check occurs when a Communications Facility instruction is executed. 
The PSW is 0802 (invalid function), and hardware register 1 contains the address 
of the Communications Facility instruction. 



<f ~>^, 
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Coding Supervisor Definition Instructions 



Syntax Notation 



During EDX system generation, you need to define certain elements of your 
Communications Facility configuration to the EDX supervisor. Examples of how 
to use these instructions during the installation process are in the chapter 
"Installing the Communications Facility" on page 251. This chapter gives the 
details of the format and operands of these Communications Facility language 
extension instructions. 

First, here's an explanation of the syntax notation that's used to describe the 
instructions in this chapter. 



Each instruction format in this chapter appears in a box with three columns: 



Name 


Operation 


Operand 









Name Field. This field contains a symboUc label of up to 8 characters. 

Operation Field. This field contains the instruction name. 

Operand Field. This field contains the operands associated with the instruction. 

The following conventions are used within the format descriptions: 

Words in BOLD CAPITAL letters must be coded exactly as shown. Commas, 
parentheses, and equal signs must also be coded exactly as shown. 

Values in BOLD UNDERSCORED letters are defaults. 

Words in italics are symbols for which you must substitute actual values. 

Brackets ([ ]) indicate that the operand is optional. 

Braces ({ }) indicate a group of mutually exclusive operands or values, of 
which you can code only one. 

A vertical bar ( | ) separates the mutually exclusive items within braces. 



o 
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Instruction Format 



The syntax of the language extensions is very similar to that of the other EDL yj^ 

instructions. For information about EDL syntax rules, see the EDX Language '^' 

Reference manual. 

The general format of the Communications Facility language extension instructions 
presented in this chapter is: 

/aZ>e/VERBMODIFIER,KEYl=va/M^7,KEY2=va/Me2,. . . 

where: 

label 

is the label to be given to the first word of the generated instruction. It is 
required only if other instructions will refer to this instruction. 

VERB 

is the name of the general operation to be performed (such as DEFINE). 

MODIFIER 

is an additional word (such as VOLUME) that further defines what the 
instruction is to do. 

The modifier names as given in this chapter are the minimum names you can 

code to specify the instructions. You can code additional letters beyond those 

required if you want. For example, DEFINE BRB is the required form of the 

instruction that defines a buffer reference block, but you can code DEFINE /f^ 

BRBLOCK if you want. V> 

KEYl, KEY2,. . . 

are keyword operands, for which you supply values. 

A space is required after the verb. No spaces are permitted between the modifier 
and the first operand, or between operands. 



Operand Formats 



The description of each operand in this chapter includes a notation of its valid 
syntax. The possibilities, for the instructions in this chapter, are: 

term 

A self -defining term. Self -defining terms are decimal constants such as the 
buff erpool size 4000 or hexadecimal constants such as the polling address 
X'C240'. 

literal 

A specific value, specified in the syntax of the instruction that requires its use. 
For example, a literal may be YES, NO, or LOCAL. A literal may also be 
alphanumeric such as the hexadecimal address 3C or the decimal number of 
error retries — 8. 
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label 

A symbolic name to represent the generated instruction. 



Supervisor Definition Instructions 



The rest of this chapter shows the format of each supervisor definition instruction, 
explains its operands, and gives an example of its use. 
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DEFINE BUFFERPOOL 



© 



DEFINE BUFFERPOOI^— Define the System Storage Pool and DCB Pool 

This instruction defines the system storage pool (S$POOL) and the device control 
block pool (S$CFDCBS). (See "Planning Storage Requirements" on page 213 for 
a description of S$POOL and S$CFDCBS, and an explanation of how to calculate 
their sizes.) Note that you can code DEFINE WORK or DEFINE POOL instead of 
DEFINE BUFFERPOOL. 

An alternative to the DEFINE BUFFERPOOL instruction is the DEFINE BRB 
instruction, which you can use to reduce the size of the supervisor. 

DEFINE BUFFERPOOL Format 



[hbet] 


DEFINE BUFFERPOOL 
DEFINE WORK 
DEFINE POOL 


tSlTEmrsize 



DEFINE BUFFERPOOL Operands 



1^' 



Operand 

label 



Syntax 

label 



Description 

The label to be assigned to the pool. The 
default label is S$POOL. Code S$CFDCBS 
when defining the DCB pool. 



SIZE. 



term 



The decimal size, in bytes, of the storage 
pool to be allocated. The maximum size is 
32,767. If you specify or a negative value, 
only a buffer reference block (BRB) is 
created; its size field contains or the 
negative value. 



DEFINE BUFFERPOOL Examples 

DEFINE BUFFERPOOL, SIZE=4000 

This instruction creates a system storage pool (S$POOL), of 4000 bytes. 

S$CFDCBS DEFINE BUFFERPOOL, SIZE=2 00 

This instruction creates a DCB pool (S$CFDCBS) of 200 bytes. 



© 
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DEFINE BRB 



DEFINE BRB — ^Define a Buffer Reference Block 



DEFINE BRB Format 



Instead of using the DEFINE BUFFERPOOL instruction to create the system 
storage pool and the DCB pool, you may use the DEFINE BRB instruction to 
create a control block, called a buffer reference blocks that defines the beginning of 
S$POOL or S$CFDCBS. Modules that will not be needed in storage after EDX 
system initialization may be located in the area following the buffer reference 
block. After initialization, this area becomes S$POOL or S$CFDCBS. 



[label] 


DEFINE BRB 


,SIZEs5ize 



DEFINE BRB Operands 



Operand 

label 



Syntax 

label 



O 



SIZE= 



term 



Desci^tion 

The label to be assigned to the buffer 
reference block. The default label is 
S$POOL. Code S$CFDCBS when defining 
the DCB pool. 



The decimal size, in bytes, of the storage 
area to be allocated (not including the 8 
bytes for the BRB). 



DEFINE BRB Example 



DEFINE BRB,SIZE=3816 

creates this buffer reference block: 

Address Contents 

1 100^* 1 108 Pointer to first word after BRB 

1102 0000 0000 2 full words of 

1106 0EE8 SIZE 

1108 First word after BRB 



o 



** Example address only. 
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DEFINE DEVICE 



DEFINE DEVICE — Define Remote Disk Access 



DEFINE DEVICE defines the information used to access one or more disks on 
another Series/ 1 as if they were on this Series/ 1. It is used in conjunction with 
one or more DISK statements that define remote disks. DEFINE DEVICE 
generates entry point and label $CFPDDB; only one DEFINE DEVICE per 
assembly is allowed. 



DEFINE DEVICE Format 



The information suppUed in DEFINE DEVICE is used to access remote disks only 
when the program dispatcher is not running in this Series/ 1 . When the program 
dispatcher is running in this Series/ 1, access to remote disks is through the paths 
defined to the program dispatcher. DEFINE DEVICE is required even if remote 
disks are not accessed until the program dispatcher is running in this Series/ 1 . 





DEFINE DEVICE 


AClJDA=polladdr \ 

mNGADR=ringaddr] 

,UNE=lmeaddr 

,CELL=cellid 

,ADDRESS=diskaddr 



DEFINE DEVICE Operands 



Operand Syntax 

CUDA= term 



Description 

A 3270 polUng address, in the form of a 
f uUword hexadecimal constant, or 0. When 
access to remote disks is over a multipoint 
BSC line specify the polling address of the 
terminal station that represents the path to 
the program dispatcher in the Series/ 1 
where the real disks are located. When 
access to remote disks is over a 
point-to-point BSC Une 
(Series/ 1-to-Series/l), specify 0. 



RINGADR= literal 



The hexadecimal Local Communications 
Controller ring address of the Series/ 1 
where the real disks are located. 



LINE= 



literal 



The hexadecimal address of the line in this 
Series/ 1 that is used to access the remote 
disks — either a BSC Une or subchannel of 
a Local Communications Controller 
attachment. 
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DEFINE DEVICE 



Operand Syntax 

CELL= literal 

ADDRESS= literal 



Description 

The cell ID of this Series/ 1. 

The hexadecimal device address of the 
remote disk. This can also be a list of 
addresses in parentheses (for example, 
ADDRESS=(E1,E2,E3)). The address is 
the one specified on the DISK statement 
that defines the remote disk. 






DEFINE DEVICE Examples 



DISK DEVICE=4962-3,ADDRESS=E1 , VOLNAME= (EDX003) 
DEFINE DEVICE, CUDA=X'C240' , LINE=9 ,CELL=S2 , ADDRESS=E1 

The DISK statement defines a remote disk with address El. The device type must 
be the same as that of the corresponding real disk. The device address must be a 
fictitious address; there must be no real disk or other device attached at that 
address. 

The DEFINE DEVICE instruction specifies that when the program dispatcher is 
not running in this Series/ 1, the corresponding real disk is accessed by means of a 
transaction sent from cell S2 on BSC line 9 using the polling address X'C240'. 
When the program dispatcher is running in this Series/ 1 , the corresponding real 
disk is accessed by means of a transaction sent with the cell ID of the program 
dispatcher to the emulated terminal station with polling address X'C240'. 

DEFINE DEVICE , RINGADR=4F , LINE=5 , CELL=S2 , ADDRESS=E 1 

This instruction specifies that when the program dispatcher is not running in this 
Series/ 1, the real disk corresponding to the one with address El is accessed by 
means of a transaction sent from cell S2 over the Local Communications 
Controller attachment at address 50 to the Series/ 1 with ring address 4F. 



.4" 
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DEFINE VOLUME 



DEFINE VOLUME — Define a Remote Disk Volume 






DEFINE VOLUME makes an entry for a remote disk volume in the volume 
descriptor cross-reference table. The first DEFINE VOLUME statement generates 
entry point and label $CFPVDE. 



DEFINE VOLUME Format 





DEFINE VOLUME 


,CELh=ceUid 

,\OLN AME=(local-name,remote-name) 

[END={YES|NO}] 



DEFINE VOLUME Operands 



Operand Syntax 

CELL= literal 

VOLNAME= literal 






END= 



literal 



Description 

The cell ID of the Series/ 1 where the real 
disk volume is located. 

The volume name used in this Series/ 1, 
followed by the real volume name. 

YES if this is the end of the volume 
descriptor cross-reference table; NO 
otherwise. 



DEFINE VOLUME Examples 



O 



DEFINE VOLUME , CELL=S J , VOLNAME= (PSD002 , EDX002 ) 

DEFINE VOLUME, CELL=SJ,VOLNAME=(EDX003,EDX003) , END=YES 

These instructions define remote volumes located in cell SJ. The first one defines 
volume EDX002, which is known as PSD002 in this Series/ L The second one 
defines the volume known as EDX003 both in this Series/ 1 and in cell SJ. 

The remote volumes and the names by which they are known in this Series/ 1 must 
be designated as performance volumes (specified in the VOLNAME operand of a 
DISK statement). 
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PCC — Define PC Connect 
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A PCC statement defines a Series/ 1 -PC Connect Attachment subchannel to the 
EDX supervisor. All PCC instructions must appear together in the $EDXDEF 
data set, and must be grouped with LCC instructions. Each Series/ 1 -PC Connect 
Attachment has three subchannels; all three subchannels must be defined for each 
Series/ 1 -PC Connect Attachment. 



PCC Format 





PCC 


ADDRESS=chanaddr 
[,END=YES] 



PCC Operands 



Operand Syntax 

ADDRESS= literal 



Description 

The hexadecimal address of the 
Series/ 1 -PC Connect Attachment 
subchannel. 



END= 



literal 



This operand must be included in the last 
PCC instruction. 



PCC Examples 



PCC ADDRESS^BO 
PCC ADDRESS=B1 
PCC ADDRESS=B2,END=YES 

The PCC instructions in this example define a PC Connect starting at address 
X'BO'. 
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/if 
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CFTERM 



CFTERM— Define Non-EDX 3101 or 7485 on Multifunction Attachment 



CFTERM defines a 3101 or 7485 terminal, on a multifunction attachment, that is 
intended for Communications Facility usage only; it is not known to the EDX 
supervisor. One or more of these instructions are used in conjunction with the 
ADAPTER statement that defines the multifunction attachment. 



CFTERM Format 



label 


CFTERM 


ADDRESS=addr 
,LMODE={RS422 | LOCAL | 
SWITCHED 1 PTTOPT} 
[,PRTS=ON 1 OFF] 



CFTERM Operands 



Operand 


Syntax 


label 


label 


ADDRESS= 


literal 






LMODE= 



literal 
RS422 



Description 

The name that identifies this terminal in the 
ADAPTER statement. 

The hexadecimal address of the 
multifunction attachment port to which the 
3101 or 7485 is connected. 

The type of connection. 

For a terminal directly attached to any port 
of the multifunction attachment. For a 
7485, you must define LMODE=RS422. 



LOCAL For a terminal directly attached. The 

terminal must be attached on the base 
address only. 

SWITCHED For a point-to-point switched connection. 
The terminal must be attached on the base 
address only. 

PTTOPT For a point-to-point nonswitched 

connection. The terminal must be attached 
on the base address only. 



PRTS= 



literal 



A permanent request to the send option. It 
applies to the base address of the 
multifunction attachment. 



#>, 
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CFTERM 



Operand Syntax 

ON 

OFF 



Description 

To set a permanent request at IPL time to 
the send function. 

To turn off the permanent request to send 
bit at IPL time. 



Special Considerations 



To turn on the permanent request to send, you must expUcitly specify PRTS=ON. 
For example, you can specify either: LMODE= SWITCHED ,PRTS= ON or 
LMODE=LOCAL,PRTS=ON. 



CFTERM Examples 



MFA3 1 1 



T3101A 
T3101B 
T3101C 



ADAPTER ADDRESS=58,TYPE=MFA, 

DEVICES=(T3101A,T3101B,T3101C; 

END=YES 
CFTERM ADDRESS=58,LMODE=RS422 
CFTERM ADDRESS=59,LMODE=RS422 
CFTERM ADDRESS=5A,LMODE=RS422 



CC 
CC 



These statements define a multifunction attachment with 3101 terminals attached 
to three ports. 



J 
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Installing the Communications Facility 



This chapter is a guide to installing the Communications Facility. It describes the 
machine-readable material you receive when you order the Communications 
Facility; explains what you need to do before you begin the installation procedure; 
and explains each step of the installation procedure. 



Machine-Readable Material 



^^\ 
\ii^ 
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The EDX Communications Facility Licensed Program, as released from the 
Information Systems Distribution (ISD), consists of machine-readable material on 
double-sided diskettes formatted with 256-byte records. These diskettes contain 
the Communications Facility modules and data sets. During the installation 
process, you add those modules and data sets to an installed Event Driven 
Executive system. The program directory that accompanies the diskettes lists the 
contents of each diskette. 

The first five diskettes are basic material: They contain loadable program modules, 
assembler overlay programs, assembler macros, object modules, and data required 
to operate the Communications Facility. The remaining diskettes are optional 
material — they contain the source code for the Communications Facility. The 
optional material is not required for the installation and execution of the 
Communications Facility. 

Data sets on the distribution diskettes are named according to the following 
conventions: 

$. Data sets with names that begin with '$.' are loadable program modules 

(executable code) or data sets. 

$4980 Data sets with names that begin with $4980 are the control store, image 
store, and microcode read access memory for 4980 terminals. 

$PCC Data sets with names that begin with $PCC are the PC Connect microcode 
patch data sets. 

A. Data sets with names that begin with 'A.' are assembler overlay programs 
that assemble the Communications FaciUty instructions for the $EDXASM 
assembler. 

CS Data sets with names that begin with 'CS' are Communications Facility 
object modules for inclusion in the EDX supervisor. 
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S$ Data sets with names that begin with 'S$' are the source code for the 
Communications Facility modules or copy code for inclusion in user 
application programs. 

0$ Data sets with names that begin with '0$' are object modules for 
Communications FaciUty multimodule programs. 

The macros, which assemble Communications Facility instructions for the $S1 ASM 
assembler, are named according to their functions within the Communications 
Facility. 
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Installation Requirements 



Before installing the Communications Facility, you must install EDX, as described 
in the EDX Installation and System Generation Guide. If you intend to use the SNA 
lOCP, you must also install the EDX Secondary SNAl Licensed Program 
(Program Number 5719-SXl) or the EDX Secondary SNA2 Licensed Program 
(Program Number 5719-XX9). You must define your SNA configuration as 
described in the EDX Secondary SNAl Guide or the EDX Secondary SNA2 Guide. 

If you intend to use the X.25 lOCP, you must also install the EDX X.25/HDLC 
Communications Support (XHCS) licensed program (Program Number 
5719-HD2). You must define your X.25 configuration as described in the EDX 
XHCS Programming and Operating Reference and the EDX XHCS Program 
Directory. 

If you intend to use the PC Connect lOCP, you must configure your Series/ 1 -PC 
Connect Attachment PC as described in the IBM Series/] -PC Connect for the 
Event Driven Executive Communications Facility, SC34-0698. 

Several EDX utiUties are required to install the Communications FaciUty: 

• $DISKUT1 is required to allocate and delete data sets. 

• $COPYUTl is required to transfer the Communications Facility modules and 
data sets to disk volumes. 

• $COPY is required to install Local Communications Controller microcode 
patches. 

• $FSEDIT is required to edit data set modules. 

• $INITDSK is required to initiaUze volumes and IPL text. 

• $EDXASM, $EDXLINK, and $XPSLINK are required to assemble and 
link-edit the supervisor. 

The EDX Operator Commands and Utilities Reference explains how to use these 
EDX utilities. 
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Installation Summary 

The steps required to install the Communications Facility are: 

1. Copy the Communications Facility basic material to disk. 

2. Convert 3 1 IF device station definitions. 

3. Allocate data sets for editing, assembling, and link-editing the supervisor. 

4. Edit the supervisor definition data set, $EDXDEF. 

5. Create the Communications Facility system storage pool (S$POOL) and DCB 
pool (S$CFDCBS). 

6. Edit the supervisor link control data set, $LNKCNTL, adding the EDX 
definition module, the system storage pool and DCB pool modules, and the 
required Communications Facility supervisor modules. 

7. Edit the assembler ($EDXASM) control data set, $EDXL, adding references 
to the overlays that process the Communications Facility language extension 
instructions. 

8. Rebuild the supervisor to include the Communications Facility support 
modules. 

9. Rewrite the IPL text to include the new supervisor, and EPL the system. 

10. Perform procedures, if necessary, to reduce the size of the supervisor. 

11. Initialize data sets for disk queuing, if any are required. 

12. Define the Communications Facility stations for your network. 

13. Create the program dispatcher data set ($.SYSPD), if the program dispatcher is 
to be used. 

14. Add IPL transactions to data set $.SYSLCC, if remote IPL through the Local 
Communications Controller is to be used. 

15. Create the X.25 data set ($.SYSX25), if you plan to use X.25 switched virtual 
circuits. 

16. Rename the SNA logon panels in data set $.SYSPNL, if you plan to 
communicate with an 8100 Distributed Processing Executive (DPPX) system. 

17. Install EDX Secondary SNAl or EDX Secondary SNA2 support, as needed. 

18. Install LU-1 support, if you plan to use Series/ 1 printers for communication 
with SNA type 1 LUs or as PC LAN-shared printers. 

19. Create the emulated PC disks, if you plan to use the disk-server. 

20. Run the sample program $.CFMENU to verify that your installation is 
complete. 
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1. Transfer the Communications Facility Basic Material to Disk 



Copy the ISD distribution diskettes to disk volumes, as explained in the program 
directory that accompanies the diskettes. 

If you copied the data sets and load modules to a volimie other than the IPL 
volume, you may need to copy some EDX modules to that volume. 

If you are going to use 4978 terminals as Communications FadUty terminals, copy: 

$4978CS0 
$4978180 

U you are going to use the remote management utility program, copy: 

CDRJP 

CDROVCP 

CDROVl 

CDROV2 

CDROV3 

CDROV4 

CDROV5 

$DISKUT3 

If you are going to use the Series/ 1 -PC Connect Attachment, copy: 

$PCCRO« 

If you copied the Communications Facility data sets and load modules to a volume 
other than the IPL volume, you may also need to copy some Communications 
Facility modules to the IPL volume. 

If you are going to use 4980 terminals as Communications Facility terminals, copy: 

$4980CSA 

$4980ISA 

$4980ROA 



2. Convert 3 10 IF Device Station Definitions 



The 3101F device station definitions for earlier releases (prior to Version 2.0) of 
the Communications Facility cannot be used with this release. If you have such 
definitions, you must convert them, as explained in the program directory that 
accompanies the distribution diskettes. 



O 
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3. Allocate Data Sets 

When you installed EDX, you had to create several data sets. Data sets 
EDITWORK and LINKWORK are probably not big enough to accommodate a 
supervisor that includes Conunimications Facility support. Use the EDX utility 
$DISKUT1 to delete them and reallocate them with the sizes shown below, and to 
allocate the data sets for the supervisor definition and system storage pool object 
modules: 

> $L $DISKUT1 

USING VOLUME EDX002 
COMMAND (?): DE EDITWORK 
COMMAND (?): DE LINKWORK 
COMMAND ( ? ) : AL EDITWORK 300 D 
COMMAND ( ? ) : AL LINKWORK 750 D 
COMMAND ( ? ) : AL $EDXDEFO 200 D 
COMMAND ( ? ) : AL CSXPOOL 50 D 

O 4. Edit the Supervisor Definition Data Set ($EDXDEF) 

Use any EDX text editor to modify $EDXDEF, adding statements that define the 
support required for your Conmiunications Facility configuration. "Coding 
Supervisor Definition Instructions** on page 235 describes the Communications 
Facility supervisor definition instructions. The EDX Installation and System 
Generation Guide describes the EDX system configuration statements. See also the 
chapter "Sample Configurations" on page 269, which shows $EDXDEF data sets 
for several sample configurations. 

EDX system generation requu-es a $SYSLOG statement in the $EDXDEF data set. 
Even though you can generate a Communications Facility system that has no 
terminals, you must include a $SYSLOG statement in $EDXDEF. 

Add COMMON and INTTMOD parameters to the SYSTEM statement. 

i The following example of the SYSTEM statement shows a common area based in 

I partition 1: 

lEDXDEF CSECT 

SYSTEM MAXPROG=(10,10,10,10) , CC 

PARTS=(32,32,32,32) , CC 

COMMON= ( CSXEND , , CSXEND , CSXEND ) , CC 

INITMOD=(CSXINIT) 

If you are going to support multiple 3101s or 7485s as 3101F stations or if you 
plan to use host communication with the Series/ 1-PC Connect Attachment, see 
"Planning Storage Requirements" on page 213 for a discussion on increasmg the 
values on the MAXPROG parameter. 
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The COMMON parameter indicates that the supervisor is to be mapped up to the 
label CSXEND in partitions 1, 3, and 4. Label CSXEND is located in the 
Communications Facility system tables in module CSXSYS. You must specify 
CSXEND for each partition in which Communications Facility programs will run. 

In the sample SYSTEM statement, Communications Facility programs can't be run 
in partition 2. The INTTMOD parameter indicates that the Communications 
Facility initialization module CSXINIT will be executed during EPL. 

In the foUowing example, the common area is not included in partition 1: 

$EDXDEF CSECT 

SYSTEM MAXPROG=(10,10,10,10), CC 

PARTS=(32,32,32,32) , CC 

COMMON= (0,0, CSXEND , CSXEND ) , C0MBASE=3 , CC 
INITMOD= (CSXINIT) 

The COMBASE parameter indicates that the common area is based in partition 3. 
The COMMON parameter indicates that the partitions 3 and 4 will be mapped up 
to the label CSXEND. Communications Facility programs may run in partitions 3 
and 4 only. 

Add statements for the support you require, as follows: 

4978 Terminals and Printers: Use TERMINAL statements to defme these to EDX. 
Be sure that the terminal name is different from the station name you use when you 
define the device to the Conmiunications Facility. 

4980 Terminals: Use TERMINAL statements to define these to EDX. Be sure (f|) 

that the terminal name is different from the station name you use when you define ^"^ 

the device to the Communications Facility. Use the ADAPTER statement to 
define the SMIO card to which the 4980s are connected. 

3101 Terminals, Feature Programmable Conmiunications or Terminal/Host Adapter: 
If you are going to use these only as emulated 3277 terminals, you need not define 
them to EDX. If you are also going to use them as EDX terminals or as 
Communications Facility work session controller terminals, use TERMINAL 
statements to define them to EDX. 

3101 Terminals, Multifunction Attachment: Use the ADAPTER statement to define 
the multifunction attachment. If you are going to use the terminals only as 
emulated 3277 terminals, use the Communications Facility CFTERM instruction to 
defme them. For example, to define three 3 101s on a multifunction attachment: 

MFA3101 ADAPTER ADDRESS=58,TYPE=MFA, CC 

DEVICES=(T3101A,T3101B,T3101C) , CC 
END=YES 

T3101A CFTERM ADDRESS=58,LM0DE=RS422 

T3101B CFTERM ADDRESS=59,LMODE=RS422 

T3 1 1 C CFTERM ADDRESS=5A , LM0DE=RS42 2 

If you are also going to use the terminals as EDX terminals or as Communications 
Facility work session controller terminals, use TERMINAL statements instead of 
CFTERM instructions to define them. 

7485 Terminals, Feature Programmable Communications or Terminal/Host Adapter: \j) 

The terminals can be used only as emulated 3277 terminals. Do not define them to 

EDX. 
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7485 Terminals, Multifunction Attachment: The tenninals can be used only as 
emulated 3277 tenninals. Use the ADAPTER statement to define the multifunction 
attachment. Use the Communications Facility CFTERM instruction to define the 
terminals. For example, to define three 748Ss on a multifunction attachment: 

MFA7485 ADAPTER ADDRESS=58,TYPE=MFA, CC 

DEVICES=(T7485A,T7485B,T7485C) , CC 
END=YES 

T7485A CFTERM ADDRESS=58,LMODE=RS422 

T7485B CFTERM ADDRESS=59,LMODE=RS422 

T7485C CFTERM ADDRESS«5A,LMODE=RS422 

BSC lines: Use the BSCUNE statement to define these to EDX. Specify 
TYPE«PT if the line is leased, TYPE-SM if the line is switched manual, or 
TYPE«SA if the line is switched auto-answer. 

Local Communications ControDer: Use EDX LCC statements to define the three 
subchannels of each Local Communications Controller attachment. 

PC Connect: Use the Communications Facility PCC instruction to define the three 
subchannels of each Series/ 1 -PC Connect Attachment. For example, to define 
one attachment: 

PCC ADDRESS=58 
PCC ADDRESS=59 
PCC ADDRESS=5A,END=YES 

If you want to support Local Communications Controller and PC Connect, you 
must define your PCC and LCC statements together. You must define all the PCC 
and LCC subchannels before specifying ENDasYES. 

You must also modify the INTTMOD parameter of the SYSTEM statement to 
include the PC Connect initialization module, CSPCCIPL. The PC Connect 
initialization module must be specified in this sequence: 

INITMOD= ( CSPCCIPL , CSXINIT ) 

Channel Attachment: The channel attachment lOCP uses the EXIO interface. Use 
the EXIODEV statement to define the channel attachment. For example: 

EXIODEV ADDRESS= 1 , MAXDCB= 1 , RSB=6 , END=YES 

SNA Connection: The SNA lOCP requires the EDX-SNA licensed program, which 
uses the EXIO interface. Use the EXIODEV statement to define the SDLC 
attachment. For example: 

EXIODEV ADDRESS=OA , MAXDCB=7 , RSB=4 , END=YES 

The Communications Facility requirements for EDX-SNA are explained in 
"Series/1-to-Host SNA lOCP, $.I014E8" on page 169. 

X.25 Connection: The X.25 lOCP requires the EDX XHCS licensed program, 
which requires an XHCDEV statement in $EDXDEF for each XHCS line. For 
example: 

LINK1A XHCDEV ( 1A, IB) ,ADAPTER=2080,END=YES 

See the XHCS Programming and Operating Reference for a complete description of 
this statement. 



Installing the Communications Facility 257 



You must also modify the INTTMOD parameter of the SYSTEM statement to 
include the XHCS initialization module, CTZOn. The XHCS module must precede 
the Communications Facility initialization module. 

INITMOD= (CTZOII , CSXINIT) 

Remote Management Utility: The remote mianagement utility, $.RMU, requires 
virtual terminal support. Use these statements to define it: 

CDRVTA TERMINAL DEVICE=VIRT,ADDRESS=CDRVTB,LINSIZE=254,SYNC=YES 
CDRVTB TERMINAL DEVICE=VIRT,ADDRESS=CDRVTA,LINSIZE=254 



Remote Disk Support: Use the DISK statement to define each disk on a remote 
Series/ 1 that will be accessed as if it were attached to this Series/ 1. The device 
address must be a fictitious address; there must be no real disk or other device 
attached at that address. The device type must be the same as that of the 
corresponding real disk. Do not specify TASKssYES. 

Use the Communications Facility DEFINE DEVICE instruction to define the path 
by which the remote disks are accessed when the program dispatcher is not running 
in this Series/ 1. This instruction is required even if the remote disks are not 
accessed until the program dispatcher is running. 

Use the Communications Facility DEFINE VOLUME instruction to define the 
local and remote names of the volumes to be accessed. 

For example, to define access over the Local Communications Controller to two 
volumes on a disk attached to the Series/ 1 known to the program dispatcher as cell 
SJ: 

*** 

$EDXDEF CSECT 

*** DISK DEFINITIONS 
**• 

DISK DEVICE=4962-3,ADDRESS=E1,VOLNAME={EDX002, LOCALS) ,TASK=NO 



*** COMMUNICATIONS FACILITY SUPPORT 

DEFINE DEVICE , LINE=50 , CELL=S2 , RINGADR=4F , ADDRESS=E 1 

DEFINE VOLUME, CELL=S J, VOLNAME= (EDX002 ,EDX002) 

DEFINE VOLUME , CELL=SJ , VOLNAME= (LOCALS , EDX003 ) , END=YES 



When you have finished editing the supervisor definition data set, save it as 
$EDXDEF. In step 8, you will assemble it into an object module named 
$EDXDEFO and include it in the supervisor. 



O 
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5. Create the System Storage Pool (S$POOL) 






The Communications Facility requires a system storage pool, included in the EDX 
supervisor, as part of the common area for all partitions in which Communications 
Facility programs will run. This pool, named S$POOL, is where the station blocks 
for aU started stations are stored. 

The Communications Facility also requires a DCB pool (S$CFDCBS), resident in 
partition 1 of the supervisor. This pool contains Device Control Blocks (DCBs) for 
stations that the Communications Facility manages without the use of 
EDX-provided I/O facilities and executable code that calls the Communications 
Facility interrupt handler routines. 

The chapter "Planning Storage Requirements** on page 213 explains how to 
calculate the size of S$POOL and S$CFDCBS. You can define these as shown in 
this step or use the alternative method described in step 10. 

To define S$POOL, use any EDX text editor to create a source data set named 
S$POOL and enter the following statements: 

CSXPOOL CSECT 

DEFINE BUFFERPOOL,SIZE=nnnn 
END 

where nnnn is the size of the pool in decimal. The DEFINE instruction generates 
the required pool name, S$POOL. In step 8, you will assemble the data set into an 
object module named CSXPOOL and include it in the supervisor. 

To define S$CFDCBS, use any EDX text editor to create a source data set named 
S$CFDCBS and enter the following statements: 

CSXDCBS CSECT 

S$CFDCBS DEFINE BUFFERPOOL,SIZE=nnnn 
END 

where nnnn is the size of the pool in decimal. The label S$CFDCBS must be coded 
as shown. In step 8, you will assemble the data set into an object module named 
CSXDCBS and include it in the supervisor. 



6. Edit the Supervisor Link Control Data Set ($LNKCNTL) 






Use any EDX text editor to modify $LNKCNTL, adding statements to include the 
supervisor definition module ($EDXDEFO), the EDX modules required to support 
the devices you defined, the Communications Facility system storage pool module 
(CSXPOOL), the Communications Facility DCB pool module (CSXDCBS), and 
the Communications Facility supervisor modules. CSXDCBS, CSA, CSPDIO, and 
CSP must be included in partition 1. The remaining Communications Facility 
supervisor modules must be included in the COMBASE partition. The modules 
cannot be in overlay segments. 

The modules required for every Communications Fadlity system are: 

• CSXPOOL, the system storage pool module. CSXPOOL must be included in 
the EDX common area. If the common area is based in partition 1, 
CSXPOOL must follow the EDX system table module, EDXSYS. 
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• CSXSYS, the Communications Fadlity system table. CSXSYS must be the 
last module mcluded in the common area. CSXSYS contains label CSXEND 
which ends the EDX common area as defined by the COMMON^ parameter 
on the SYSTEM statement. 

• CSXDCBS, the DCB pool module. CSXDCBS must reside in partition 1, but 
not necessarily in the common area. 

• SEDXDEFO, the supervisor definition module, and CSP, the supervisor 
Communications Facility parameter table. $EDXDEFO and CSP must be 
included in partition 1. Include $EDXDEFO and CSP after the CSXSYS 
module if you are basing the common area in partition 1. If not, the location of 
these modules in partition 1 is not important. 

• CSA, the module that provides a universal attention capability for the 
command processor and program dispatcher commands. This module must be 
included in partition 1, outside the common area. 

• CSP, the Communications Facility parameter table. This module must be 
included in partition 1, outside the common area. 

• CSF, CSM, and CSX, the Communications Facility instruction support. These 
modules must be included in the CSXSYS (COMBASE) partition, after 
module CSXSYS. 

• CSXINTT, the Communications Facility initialization module. Include 
CSXINIT in partition 1, before the $EDXSVCX module in the static portion 
of the supervisor. 

The EDX Installation and System Generation Guide explains which EDX modules 
are required to support various devices and functions. Include the support you 
require, as follows: 

4978 Terminals and Printers: Include EDX terminal support. 

4980 Terminals: Include EDX terminal support, 4980 power-on read access 
memory support, and SMIO attachment support. 

3101 Terminals, Feature Programmable Communications or Terminal/Host Ad^ter: 

Include EDX unmapped storage support. If you are going to use the terminals as 
EDX terminals or as Communications Facility work session controller terminals, 
include EDX terminal support. 

3101 Termmals, Multifunction Attachment: Include EDX unmapped storage 
support and multifunction attachment support. K you are going to use the 
terminals as EDX terminals or as Communications Facility work session controller 
terminals, include EDX terminal support. 

7485 Terminals, Feature Programmable Communications or Terminal/Host Adapter: 

Include EDX unmapped storage support. 

7485 Terminals, Multifunction Attachment: Include EDX unmapped storage 
support and multifunction attachment support. 

ESC Lines: Include EDX BSC support. 
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Local Communicatioiis Controller: Include EDX Local Communications Contioller 
support. 

PC Connect: Include EDX Local Communications Controller support. Include 
Communications Facility modules CSPCCINT, CSPCCIPL, CSPCCOPN, and 
CSPCCPTC. Modules CSPCCOPN, CSPCCPTC, and CSPCCINT may be in 
overlay segments (each in its own overlay segment). Module CSPCCIPL cannot 
be in an overlay segment. 

Channel Attachment: Include EDX EXIO control support. 

SNA Connection: Include EDX EXIO control support. 

X.25 Connection: Include XHCS modules CTZOIA and CTZOn, as explained in 
the XHCS Program Directory. 

Remote Management Utility: Include EDX virtual terminal support. 

C<Hifiguration Processor and Panel Utility: Include EDX full message support. 

Remote Disk Support: In a Series/ 1 that accesses remote disks, include EDX basic 
disk support. Include specific disk device support modules only for real disk 
devices, if any. Include Communications Facility modules CSPDIO and 
CSXRDINT. CSPDIO must be included before $EDXSVCX in the static portion 
of the supervisor. 



O I $LNKCNTL Examples 



Following are examples of $LNKCNTL data sets, showing where Conununications 
Facility modules are included. The first example shows a system with the common 
area based in partition 1. The second example shows a system with the common 
area based in partition 3. Those marked with a single asterisk on the left are the 
optional remote disk support modules. 
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Examples—Common Area Based in Partition 1 



*** SUPERVISOR SUPPORT 
PART 1 

VOLUME XS4002 

INCLUDE EDXSYS •I* 

INCLUDE CSXPOOL,EDX002 *CF* 
INCLUDE CSXSYS,ASMLIB *CF* 

♦INCLUDE CSPDIO,ASMLIB »CF* 



DEFAULT VOLUME FOR INCLUDE 
SYSTEM TABLES AND WORK AREAS 
C.F. SYSTEM STORAGE POOL 
C.F. SYSTEM TABLE 
C.F. REMOTE DISK SUPPORT 



INCLUDE CSXINIT,ASMLIB *CF* C.F. INITIALIZATION 

INCLUDE $EDXDEFO,EDX002 *1* OUTPUT FROM USER SYSTEM GENERATION 



*** COMMUNICATIONS FACILITY SUPPORT 

♦INCLUDE CSXRDINT,ASMLIB ♦CF^ REMOTE DISK INITIALIZATION 

LANGUAGE EXTENSION SUPPORT 
C.F. GET/PUT SUPPORT 

SEND/RECEIVE SUPPORT 
C.F. GLOBAL ATTENTION SUPPORT 
DCB POOL 
PARAMETER TABLE 



INCLUDE 


CSX,ASMLIB 


♦CF^ 


C.F. 


INCLUDE 


CSF,ASMLIB 


♦CF^ 


C.F. 


INCLUDE 


CSM^ASMLIB 


♦CF^ 


C.F. 


INCLUDE 


CSA,ASMLIB 


♦CF^ 


C.F. 


INCLUDE 


CSXDCBS 


♦CF^ 


C.F. 


INCLUDE 


CSP 


♦CF^ 


C.F. 



♦♦♦ SYSTEM SUPPORT — INITIALIZATION 



INCLUDE CSPCCINT^ASMLIB ♦CF^ 

INCLUDE CSPCCIPL,ASMLIB ♦CF^ 

INCLUDE CSPCCOPN,ASMLIB ♦CF^ 

INCLUDE CSPCCPTCASMLIB ♦CF^ 



PCC INITIALIZATION 

PCC INITIALIZATION CALL ROUTINE 

PCC MICROCODE DATA SETS OPEN ROUTINE 

PCC MICROCODE RAM LOAD ROUTINE 



♦♦♦ SUPERVISOR SUPPORT OUTSIDE PARTITION 1 



LINK $EDXNUCT,EDX002 



Example — Common Area Based in Partition 3 



♦♦♦ SUPERVISOR SUPPORT 

PART 1 

VOLUME XS5202 

INCLUDE EDXSYS 

INCLUDE CSXINIT 
♦INCLUDE CSPDIO 

INCLUDE $EDXDEFO 



DEFAULT VOLUME FOR INCLUDE 
♦ 1 ♦ SYSTEM TABLES AND WORK AREAS 
♦CF^ C.F. INITIALIZATION MODULE (PARTITION 1) 
♦CF^ REMOTE DISK SUPPORT (PARTITION 1) 

OUTPUT FROM USER SYSTEM GENERATION 



♦♦♦ COMMUNICATIONS FACILITY SUPPORT 



♦INCLUDE CSXRDINT,ASMLIB ♦CF^ 
INCLUDE CSXDCBS ♦CF^ 

INCLUDE CSP ♦CF^ 

INCLUDE CSA ♦CF^ 

INCLUDE CSA,ASMLIB ♦CF^ 



REMOTE DISK INITITU^IZATION 

C.F. DCB POOL 

C.F. PARAMETER TABLE 

C.F. GLOBAL ATTENTION SUPPORT 

C.F. GLOBAL ATTENTION SUPPORT 



PART 3 

♦♦♦ COMBASE PARTITION 

INCLUDE CSXPOOL 

INCLUDE CSXSYS 
♦♦♦ END COMMON AREA 



♦!♦ C.F. SYSTEM STORAGE POOL 
♦!♦ C.F. SYSTEM TABLE 



INCLUDE CSX 
INCLUDE CSF 
INCLUDE CSM 



♦CF^ C.F. LANGUAGE EXTENSION SUPPORT 
♦CF^ C.F. GET/PUT SUPPORT 
♦CF^ C.F. SEND/RECEIVE SUPPORT 



c# 



LINK $EDXNUCT,EDX002 
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Save the edited version of $LNKCNTL on EDX002. 



1. Edit the Assembler Control Data Set ($EDXL) 






Use any EDX text editor to edit the $EDXL control data set on ASMLIB to 
include the overlays that compile the Communications Facility language extension 
instructions. Merge the data set A.EDXL (statements 10-50) between the last 
OVERLAY statement and the first COPYCOD statement, and before any 
EXTLIB statement. 

If you need to assemble the X.25 lOCP or other programs which use XHCS 
instructions, you must include an EXTLIB statement in $EDXL for the data set 
$XHCL. ($XHCL is shipped with XHCS.) 

If you need to assemble the SNA lOCP or other programs which use SNA 
instructions, you must include an EXTLIB statement in $EDXL for the data set 
$EDXLSNA. 

A partial listing of the merged data sets in the workspace should show: 

♦OVERLAY A.CFID ASMLIB CFID 

♦OVERLAY A.CFTERM ASMLIB CFTERM 

♦OVERLAY A.CSXDEF ASMLIB DEFINE 

♦OVERLAY A.GETPUT ASMLIB GET PUT MOV 

♦OVERLAY A.SENREC ASMLIB ACTIVATE FREE LOCATE RECEIVE SEND 

♦COPYCOD ASMLIB 

♦COPYCOD EDX002 

♦♦STOP^^ 



Save the edited version of $EDXL on ASMLIB. The PCC instruction will 
assemble without an entry in $EDXL. 



8. Rebuild the Supervisor 



Perform these steps to rebuild the supervisor: 

1. Assemble the supervisor definition statements in $EDXDEF (which you saved 
in step 4) and store the object module in $EDXDEFO: 

> $L $EDXASM, ASMLIB $EDXDEF ASMWORK $EDXDEFO 

2. Assemble S$POOL and S$CFDCBS (which you created in step 5) and store 
the object modules in CSXPOOL and CSXDCBS: 

> $L $EDXASM, ASMLIB S$POOL ASMWORK CSXPOOL 

> $L $EDXASM, ASMLIB S$CFDCBS ASMWORK CSXDCBS 
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3. Link-edit the supervisor, using the link control data set, $LNKCNTL, which 
you created in step 6: 

> $L $XPSLINK LINKWORK 

Enter $LNKCNTL when you are prompted for parameters. Check the 
link-edit printed output to be sure that there are no unresolved external 
references and that the supervisor is not larger than 64K in any partition. 
You'll get unresolved external references if you've defined remote disks with 
types that aren't attached to the Series/ 1, because you didn't include specific 
disk support modules. These errors are all right; the unresolved labels will 
never be referenced. If the supervisor is too large, compact it as explained in 
step 10. 



9. Rewrite IPL Text and Re-IPL 



Use the n (initialize IPL text) command of the EDX utility $INITDSK to rewrite 
IPL text: 

> $L SINTTDSK 

COMMAND (?) : U 
NUCLEUS: $EDXNUCT 
VOLUME: EDX002 
IPL TEXT WRITTEN 

Press the LOAD button to re-IPL the system with your new supervisor that 
supports the Communications Facility. 



10. Compact the Supervisor 



If the supervisor exceeds the 64K partition size limit, you can use one or more of 
the three methods described in this section to compact it. 

The first method is to use the supervisor overlay support, which is described in the 
EDX Installation and System Generation Guide. You must place CSXINIT, 
CSPCCIPL (if PC Connect is used), and CSXRDINT (if remote disk support is 
used) before the INCLUDE statement for the overlay manager. These modules 
cannot be in overlay segments, even though they are user initialization modules. 

The second method is to move part of the supervisor outside partition 1, as 
explained in the EDX Installation and System Generation Guide. Remember that 
you can move the EDX common area, and many associated Communications 
Facility modules, out of partition 1. This will free the storage that would have been 
reserved for S$POOL and CSXSYS in partition 1 for the rest of the supervisor. 

The third method is to use the storage reserved in partition 1 for S$P(X)L or 
S$CFDCBS to contain supervisor modules during the early part of the IPL process. 
This method may be applied to S$POOL only if it is included in partition \. 

Because the CSXINIT module initializes S$POOL late in the IPL process, you can 
use the S$POOL storage for other purposes before CSXINIT receives control. 
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To use the S$POOL area in partition 1 before initialization, follow these steps: 

1 . Change the DEFINE BUFFERPOOL instruction in the S$POOL data set to: 

DEFINE BRB,SIZE=nnnn 

where nnnn is the size, in decimal, of S$POOL plus 8 bytes. 

2. Reassemble the module. 

3. Modify the $LNKCNTL data set by moving one or more INCLUDE 
statements for supervisor initialization modules between the INCLUDE 
CSXPOOL statement and the INCLUDE CSXSYS statement. You may use 
almost any of the initialization modules as long as their combined size exceeds 
the size specified in the DEFINE BRB instruction. If their size is less, 
S$POOL will overlay module CSXSYS. 

You can include Communications Facility initialization modules in this area 
(CSXINTT, CSXRDINT. CSPCCINT, CSPCCIPL, CSPCCOPN, and 
CSPCCPTC). Do not include EDXINTT in this area. 

Use the link-edit map from your initial link-edit to determine the sizes of the 
initialization modules. 

4. Link-edit the supervisor. 

5. Check the supervisor size. If it's acceptable, rewrite the IPL text and re-IPL 
the new supervisor. 

Because S$CFDCBS is not initialized untU Communications Facility programs are 
loaded into storage after IPL is complete, S$CFDCBS storage is available during 
the entire IPL process. 

To use the S$CFDCBS area before initialization, follow these steps: 

1 . Change the DEFINE BUFFERPOOL instruction in the S$CFDCBS data set 
to: 

S$CFDCBS DEFINE BRB,SIZE=nnnn 

where nnnn is the size, in decimal, of the Communications Facility DCB pool 

2. Reassemble the module. 

3. Modify the $LNKCNTL data set by moving one or more INCLUDE 
statements for supervisor modules immediately after the INCLUDE 
CSXDCBS statement in partition 1. You may use almost any of the 
initialization modules as long as their combined size exceeds the size specified 
in the DEFINE BRB instruction. A significant size reduction in the supervisor 
is achieved only if the DCB pool is almost as large as the total size of the 
initialization modules you want to include in this area. As described before for 
using the S$POOL area, you may use Communications Facility initialization 
modules, but do not include EDXINIT in this area. 

4. Link-edit the supervisor. 
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5. Check the supervisor size. If it's acceptable, rewrite the IPL text and re-IPL 
the new supervisor. 

Note: This technique is appropriate only if you have defined a relatively large 
DCB pool. 



11. Initialize Data Sets for Disk Queuing 



If you use disk queuing of messages, you need to allocate and initialize disk-queue 
data sets. The chapter "Creating Disk-Queue Data Sets" on page 207 explains 
how to do this. 



12. Define the Communications Facility Stations 



Define the stations required to represent your hardware and software 
configuration. 

The chapter "Defining Stations" on page 45 explains how to define stations and 
gives worksheets to use to record your station definitions. 

FiU out those worksheets, and then use the DEFINE and LINK commands of 
$. CONFIG or the command processor to build the network configuration data set, 
$.SYSNET. 

The chapter "Sample Configurations" on page 269 gives many examples of station 
definition worksheets. 



O 



O 



13. Create the Program Dispatcher Data Set ($.SYSPD) 

If you are going to use the program dispatcher, you must set up a $.SYSPD data 
set, which contains commands, path definitions, transaction definitions, and 
transactions that are to be processed when the program dispatcher is started. The 
chapter "Creating $.SYSPD" on page 187 explains how to do this. 

The chapter "Sample Configurations" on page 269 shows several sample $.SYSPD 
data sets. 

14. Create the IPL Transaction Data Set ($.SYSLCC) 

If you plan to process hardware IPL requests initiated at remote nodes on a Local 
Communications Controller ring, you must create a $.SYSLCC data set that 
contains the appropriate IPL transactions. The section "Remote IPL" on page 37 
explains the usage of $.SYSLCC. 

" Example 9: Local Communications Controller Connection with Transaction ^^^^ 

Processing" on page 354 in the chapter "Sample Configurations" includes a ^J) 

sample $.SYSLCC data set. ^ 
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15. Create the X.25 Call ID Data Set ($.SYSX25) 



If you plan to use the X.25 I/O control program ($.IO0AB8) with switched virtual 
circuits, you must create the $.SYSX25 data set that contains the circuits' call IDs 
matched with the appropriate X.25 network address. The section "X.25 Call ID 
Data Set ($.SYSX25)" on page 184 explains how to do this. See "Example 13: 
X.25 Connection Between Series/ Is through an X.25 Network" on page 338 or 
"Example 14: X.25 Connection between a Series/1 and DTEs" on page 352 a 
$.SYSX25 data set. 

You need not modify the supplied version of $.SYSX25 for use with PVC circuits. 



16. Customize Logon Prompt Panel for SNA lOCP 



If you plan to use the Communications Facility to connect to an 8100 Distributed 
Processing Executive (DPPX) system, you must use an alternate SNA logon 
prompt screen. Rename members SNALOGON and SNALOG02 in the 
$.SYSPNL library using the EDX utiUty $DIUTIL: 

>$L $DIUTIL $.SYSPNL 

COMMAND (?): RE SNALOGON SNALOGOl 

RENAME COMPLETED 

COMMAND ( ? ) : RE SNALOG02 SNALOGON 

RENAME COMPLETED 

The alternate screen has separate fields for USERID and PASSWORD. Other host 
systems use the USER DATA field for these parameters. 



17. Install EDX Secondary SNAl or SNA2 Support 



Relink the SNA lOCP ($.I014E8) with $NETCMD, if you plan to use EDX 
Secondary SNAl. Link $.I014E8 with $NETCMD and $NETPACT if you plan 
to use EDX Secondary SNA2 and $.I014E8 with multiple PU support. 



18. Install LU-1 Support 






If you plan to use Series/ 1 printers for communication with SNA type 1 LUs or as 
PC LAN-shared printers, you must add LU-1 support to the printer I/O control 
program ($.100674). 

Link these modules in the order listed to create the load module $.100674: 

. O$IO0674 

. O$IO0675 

. O$IO0676 

. O$IO0677 
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19. Create Emulated PC Disks 



If you plan to use the disk-server support, you must use the emulated PC disk 
management utility, $.DSFORM, to create the emulated PC disks you need on a 
Series/ 1 volume. See the Operator's Guide for more information on $.DSFORM. 



20. Use $.CFMENU to Verify Installation 



You can verify that you have installed the Communications FaciUty correctly and 
test certain communications functions by using the sample program $.CFMENU. 

The functions you can test are: 

• Communication with 3270 display stations. 

• Communication with 4978, 4980, 3101, or 7485 terminals being managed as if 
they were 3277s. 

• Communication with a host using 3270 emulation. Series/ 1-to-host channel 
attachment, or Series/ 1-to-host SNA. 

To use the sample program, you must first define it to the Communications Facihty 
as a user station. Use $. CONFIG to define the program as a user station, with 
station name $.CFMENU and a network address appropriate to your 
configuration. 

Issue one of these commands to start the Communications FaciUty: U J 

> $L $.CFS 

> $L $.CFD 

Issue this command to start the sample program: 

> CP S $.CFMENU 

Issue commands to link one or more terminals to the program. For example, to link 
T4978 to the program, you would enter: 

> CP LINK T4978 $ . CFMENU 

If the terminal hasn't been started, issue a command to start it: 

> CP S T4978 

Begin communication with $. CFMENU by pressing the ENTER key of a terminal 
Unked to it. The menu shown in Figure 40 on page 267 will be displayed on the 
screen. When the display appears, you have successfully tested communication 
with the terminal. 



o 
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#<t*»«*<.A«**««**«««««««*««««***««« ««**<=«********«****«********* ***************** 

EVENT DRIVEN EXECUTIVE COMMUNICATIONS FACILITY 

SAMPLE PROGRAM 

*<t<t5{t«<t«<C#*#*«#««««#««« ««**«««**««♦*«****«*««***************** ****************** 



CONNECT TO HOST: 

CONNECT TO APPLICATION PGM: 

LOAD SFSEDIT UNDER EOX: 

DISCONNECT THIS TERMINAL: 

===> TAB TO FIELD AND ENTER DATA 



(ENTER HOST TERMINAL NAME) 

(ENTER PROGRAM NAME) 

(ENTER WORKFILE NAME) 

(ENTER ANY CHARACTER) 



Figure 40. $.CFMENU Menu 






To test communication with a host, you must first define the appropriate line and 
terminal stations, or the SNA physical and logical unit stations, and start them. For 
example, to start a 3270 emulation line and an emulated control unit and terminal, 
enter this command at a terminal that is not Unked to $.CFMENU: 

> CP S HOST CU71 T770 

Then enter the name of the emulated terminal station in the sample program menu 
and press ENTER. A screen image from the host program should be displayed on 
the terminal's screen. 

You can use the sample program to link to another Communications Facility 
application program, such as $. PANEL, the panel design aid program. You must 
first define the program, specifying a network address appropriate to your 
configuration, and start it: 

> CP DEF $. PANEL 0188 USER 

> CP S $. PANEL 

You can load the EDX full-screen editor from a 4978 terminal by entering the 
name of an edit work file in the sample program menu. Note that the sample 
program is not intended to be used as a session manager. It does not allow you to 
specify where the editor is loaded or a work file volume name. 

To end a single session with $.CFMENU and return the terminal to control of 
EDX, enter any character in the fourth field of the menu. 

To end the use of $.CFMENU, issue a command to stop it: 

> CP P $.CFMENU 
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Sample Configurations 









This chapter presents sample Communications Facility configurations: 

1. BSC connection to a host, with a 4978 terminal, a 4980 terminal, and a printer. 

2. Channel attach connection to a host, with 3101 terminals on a multifunction 
attachment. 

3. EDX Secondary SNAl connection to a host, with 3270 terminals and printer. 

4. EDX Secondary SNA2 connection to a host, with 3270 terminals and printer. 

5. Local Communications Controller connection between Series/ Is, with 3101 
terminals on a feature programmable communications adapter. 

6. BSC point-to-point connection between Series/ Is, with 3101 terminals on a 
feature programmable communications adapter. 

7. BSC multipoint connection between Series/ Is. 

8. BSC multipoint connection with transaction processing. See "Remote IPL" on 
page 37 for restrictions. 

9. Local Communications Controller connection with transaction processing. See 
"Remote IPL" on page 37 for restrictions. 

10. BSC point-to-point connection with transaction processing. 

1 1 . Multiple Local Communications Controller and BSC connections. 

12. X.25 leased line connection between Series/ Is with a permanent virtual circuit. 

13. X.25 network connection between Series/ 1 with switched virtual circuits. 

14. X.25 connection between Series/ Is and through an X.25 network with packet 
devices. 

15. LAN with Series/ 1 -PC Connect Attachment and SNA connection. 

16. PC Connect with inter-LAN services. 

Each example includes a diagram of the configuration and an explanation of the 
message flow between stations. The diagram shows the hardware elements and 
their device addresses, the Communications Facility stations, and the links between 
stations. Stations are shown as boxes within the Series/ 1 box. Vector stations, 
those that represent elements in a remote node, are shown as dotted boxes. Links 
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between stations are shown as dashed lines with arrows that indicate the direction 
of the hnk. 

Each example also includes the station definitions and EDX definitions. The EDX 
definitions contain only the statements required to define and support the hardware 
and functions used by the elements of the sample configuration. When you define 
your configuration, you will need to add statements for basic EDX functions and 
for other hardware, such as EDX terminals, disks, and diskettes. 

Where apphcable, the example also includes other definitions required to support 
the configuration, such as EDX-SNA definitions, host system definitions, and 
program dispatcher data sets. 

You can use the sample configurations, individually or combined, as models when 
you define your configuration. For example, if your configuration includes 
Series/ Is connected by a Local Communications Controller with an SNA 
connection from one of the Series/ Is to a host system, combine the information 
presented in examples 3,4, and 5. 



r' 



\J 



^^kmJ^ 



270 Communications Facility Design and Installation Guide 



Sample Configurations 27 1 



Example 1: BSC Connection to a Host 



Figure 41 shows a configuration in which a Series/ 1 is connected to a host 
computer by a BSC multipoint line. The Series/ 1 appears to the host as a remote 
3271 control unit with two 3277 display stations and a 3286 printer. The real 
devices are a 4978 terminal, a 4980 terminal, and a 4974 printer. 



/■ 



Host 




.^'~\^ 

''^y 



Figure 41. Example 1: BSC Connection to a Host 
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Message Flow 



To achieve the flow of messages between the Series/ 1 devices and the host, each 
device station and its associated emulated terminal or device station are linked to 
each other. When an operator enters data at the 4978 represented by station 
T4978A, the 4978/4980 data stream lOCP, $.100670, reads the data, converts it 
to a 3270 data stream, and sends it to T4978A's link, station E3277A. 
Subsequently, the 3270 emulation lOCP, $.IO0AE0, retrieves the message from 
E3277A's queue and writes it to the associated BSC line, station HOST. 



$.100 AEO also reads data from the host, and disposes of it according to the 3270 
polling and selection address that you defined for the emulated terminal stations. 
For example, data with selection address X'6040' is intended for station E3277A, 
so it is sent to that station's link, station T4978A. Subsequently, $.100670 
retrieves the message from T4978A's queue, decodes the 3270 data stream, and 
writes the data to the 4978. 

Notice station E3271, which represents the emulated 3271 control unit. Although 
this station does not send or receive messages, it is required for communication 
over a BSC multipoint line. 



Station Definitions 



g^\ 



Figure 42, Figure 43 on page 274, and Figure 44 on page 275 show the station 
definitions. In Figure 43 on page 274, notice that a partitioned data set member 
has been specified for the printer station. As a result, a member named PRTR will 
be allocated in data set $.SYSPRT, and the printer can be supported as a buffered 
device. 



User /Message /Alias /Volume Configuration Worksheet 



System: Example 1 : BSC Connection to Host 
Node Assignment: 01 



Description 


Name 


NA 


Type 


AUas> 


3270 Emulation lOCP 


S.IOOAEO 


01 AA 


USER 




4978/4980 Data Stream lOCP 


$.100670 


OlAB 


USER 




Printer lOCP 


$.100674 


OlAC 


USER 





' Specify only for alias station 



SSPOOL Storage 



3 User/Msg Stations 

Alias Stations 

Remote Stations 

Volume Stations 






X 88 = 264 bytes 

X 40 = bytes 

X 32 = bytes 

X 104 = bytes 



Figure 42. Example 1: User/Message/ Alias/Volume Configuration Worksheet 
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Device Configuration Worksheet 



System: Example 1: BSC Connection to Host 
Node Assignment: 01 



Description 


Name 


NA 


Type 


Device Type 


Buffer 
Size 


PDS» 


Polling 
CUDA 


Selection 
CUDAV 
HDCPY' 


Bit Rate' 


Auto 
Ans' 


4978 


T4978A 


0104 


DEVICE 


4978 


2500 




4040 


0000 






4980 


T4980A 


0114 


DEVICE 


4978 


2500 




4040 


0000 






Printer 


PRTR 


0121 


DEVICE 


PRINTER 


2500 


Y 


4040 


0000 







' Specify only for printer device station 
^ Specify only for printer or 4978 device station 
' Specify only for 3101 or 3 101 F device station 
" Specify only for 3 101 F device station 
For 7485's, bit rate must be 9600 and AUTO ANS=NO 



S$POOL Storage 



.3 10 IF Devices 



X 160 = 



. bytes 



3 4978/Printer Devices 

3101 Devices 

Remote Stations 



X 264 = 792 bytes 

X 304 = bytes 

X 32 = bytes 



\ 



] 



Figure 43. Example 1: Device Configuration Worlmheet 
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Line / Terminal / Node Configuration Worksheet 



System: Example 1: BSC Connection to Host 
Node Assignment: 01 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


BSC line to host 


HOST 


0109 


LINE 


327 IE 


2500 









Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name* 


Polling 

CUDAV 

Portr 


Select 
CUDA» 


Emulated control unit 


E3271 


OlEl 


TERM 


3271 




HOST 




407F 


0000 


Emulated terminal 


E3277A 


01E2 


TERM 


3277 




HOST 




4040 


6040 


Emulated terminal 


E3277B 


01E3 


TERM 


3277 




HOST 




40C1 


60C1 


Emulated printer 


E3286 


01E4 


TERM 


3286 




HOST 




40C2 


60C2 



' specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
» Specify only for 3271, 3277, or 3286 terminal station 

* Specify only for port terminal station 

' Specify only for DCE or DTE line station 

* Specify only for PC node station 



S$POOL Storage 



.HDLC Lines 



xll2 = 



. bytes 



1 Other Line 

4 Terminals/Nodes 

Remote Stations 



X 264 = 264 bytes 
X 88 = 352 bytes 
X 32 = bytes 



Figure 44. Example 1: Line/Terminal/Node Configuration Worksheet 
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EDX Definitions 



Figure 45 shows the EDX definitions for example 1. You must define the 4978, 
4980, and the printer to EDX even though you might use them only as 
Communications Facility terminals. Notice the definition of PRINT2, the printer 
to be used as if it were a 3286. The definition is based on the assumption that the 
host system controls pagination with NL (new line) control orders in the data 
streams that it sends to the printer. If the host system controls pagination with FF 
(forms feed) control orders, you should change the definitions of the top and 
bottom margins. 



1 



*** EXAMPLE 1 
*** 

$EDXDEF 



CSECT 

SYSTEM MAXPROG=(10, 10) , PARTS= (32 , 32 ) , 

COMMON=(CSXEND,CSXEND) , 

INITMOD=(CSXINIT) 



SMIO01 ADAPTER ADDRESS=80 , TYPE=SMIO,DEVICES= {TERM2) ,END=YES 

TERM! TERMINAL DEVICE=4978 ,ADDRESS=04 ,HDCOPY=$SYSPRTR 

TERM2 TERMINAL DEVICE=4980 , ADAPTER=SMIO, ADDRESS=80 , X 

SECADDR=0 1 , PORT=0 
$SYSPRTR TERMINAL DEVICE=4973 , ADDRESS=01 
PRINT2 TERMINAL DEVICE=4974,ADDRESS=21 , X 

PAGSIZE=66 , TOPM=0 , BOTM=65 , END=YES 



BSCLINE 
END 



ADDRESS=09,TYPE=MT,END=YES 3271 EMULATION 



Figure 45. Example 1: EDX Definitions 
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Example 2: Channel Attach Connection to a Host 



Figure 46 on page 279 shows a configuration in wliich a Series/ 1 is connected to 
an IBM System/370 computer by a channel attachment. The Series/ 1 appears to 
the host as a locally-attached 3272 control unit with two 3277 display stations. 
The real devices are a 3101 and a 3161 terminal attached to the Series/ 1 by a 
multifunction attachment. 



f-^^^, 

O 



Message Flow 



To achieve the flow of messages between the Series/ 1 devices and the host, each 
device station and its associated emulated terminal station are linked to each other. 
A user application program (station APROG) is included in this example to 
illustrate how you can intercept all messages sent by an lOCP. 

When an operator enters data ata3101 ora3161 terminal, the 3101 lOCP, 
$.IO06F0, reads the data, converts it to a 3270 data stream, and sends it to the 
lOCP's link, station APROG. The application program can do whatever you 
require with the messages it receives; for example, it might check them for validity 
or write them to a data set as an audit trail. The origin of the messages is the input 
device station (T3101A or T3101B), not the I/O control program. Therefore, the 
application program can send messages on to the host by sending them to the origin 
station's link (PORTA or PORTE). The channel attach lOCP, $.IO0AD0, 
retrieves messages from PORTA's and PORTB's queues and writes them to the 
associated channel, station CHAN. 

$.100 ADO disposes of data sent by the host according to the port number that you 
defined for the emulated terminal stations. For example, data for port is intended 
for station PORTA, so the lOCP sends it to PORTA's link, station T3101A. 
Notice that with a channel attachment, there is no station that represents the 
emulated 3272 control unit. 






Station Definitions 



In this example, there is no program to intercept messages from the host. You 
could intercept them by linking $.100 ADO to APROG or to some other application 
program. See the Programmer's Guide for information about writing programs to 
intercept messages from I/O control programs. 



Figure 47 on page 280, Figure 48 on page 281, and Figure 49 on page 282 
show the station definitions. 
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3161 



3101 



DA = 58 



DA = 59 



System/370 



Series/ 1 



$.IO0AD0 



Channel 



DA= 10 



CHAN 



PORTA 



PORTB 



1 f 



T3101A 



T3101B 



$.IO06F0 



J 



APROG 



Figure 46. Example 2: Channel Attach Connection to a Host 
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User /Message /Alias I Volume Configuration Worksheet 



System: Example 2: Channel Attach Connection to a Host 
Node Assignment: 01 



Description 


Name 


NA 


Type 


AUas' 


Channel attach lOCP 


S.IOOADO 


OlAA 


USER 




3101-MFAIOCP 


$.1006 FO 


OlAB 


USER 




User application program 


APROG 


OlAC 


USER 





Specify only for alias station 



S$POOL Storage 



3 User/Msg Stations 

Alias Stations 

Remote Stations 



-Volume Stations 



X 88 = 264 bytes 

X 40 = bytes 

X 32 = bytes 

X 104 = bytes 



Figure 47. Exaiiq)le 2: User/Message/ AKas/Volume Configuration Worksheet 
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Device Configuration Worksheet 



System: Example 2: Channel Attach Connection to a Host 
Node Assignment: 01 



Description 


Name 


NA 


Type 


Device Type 


Buffer 
Size 


PDS' 


Polling 
CUDA 


Selection 
CUDAV 
HDCPY» 


Bit Rate' 


Auto 
Ans* 


3161 


T3101A 


0158 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


4800 


Y 


3101 


T3101B 


0159 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


4800 


Y 



' Specify only for printer device station 
^ Specify only for printer or 4978 device station 
' Specify only for 3101 or 3 101 F device station 
" Specify only for 3101 F device station 
For 7485's, bit rate must be 9600 and AUTO ANS=NO 



S$POOL Storage 






-3 101 F Devices 
-4978/Printer Devices 



2 3101 Devices 
Remote Stations 



F^ure 48. Example 2: Device Configuration Worksheet 



xl60 = , 
X 264 = 



. bytes 
, bytes 



X 304 = 608 bytes 
X 32 = bytes 



EDX Definitions 



Figure 50 on page 283 shows the EDX definitions for example 2.. Notice that the 
CFTERM instruction is used to define the 3101 and 3161, so you can use them 
only as Communications Facility terminals. If you also want to use them as EDX 
terminals, use the TERMINAL statement to define them instead. 



#% 
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Line I Terminal /Node Configuration Worksheet 



System: Example 2: Channel Attach Connection to Host 
Node Assignment: 01 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size* 


Window' 


Channel attachment 


CHAN 


0110 


LINE 


CA 


2500 









Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name* 


Polling 

CUDAV 

Portr 


Select 
CUDA» 


Emulated 3277 


PORTA 


OlEl 


TERM 


PORT 




CHAN 









Emulated 3277 


PORTB 


01E2 


TERM 


PORT 




CHAN 




1 





' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
■• Specify only for port terminal station 
' Specify only for DCE or DTE line station 
* Specify only for PC node station 



/It %i 



S$POOL Storage 



.HDLC Lines 



X 112 = 



bytes 



1 Other Line 

2 Terminals/Nodes 
Remote Stations 



X 264 = 264 bytes 
X 88 = 176 bytes 
X 32 = bytes 



Figure 49. Example 2: Line/Terminal/Node Configuration Worksheet 
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*** EXAMPLE 2 
*** 

$EDXDEF CSECT 

SYSTEM MAXPROG=(10, 10) , PARTS= ( 32 , 32 ) , 
COMMON=(CSXEND,CSXEND) , 
INITMOD=(CSXINIT) 



$SYSPRTR TERMINAL DEVICE=4973 , ADDRESS=01 ,END=YES 

MFA01 ADAPTER ADDRESS=58 , TYPE=MFA, DEVICES= (TERMA, TERMB) , END=YES 

TERMA CFTERM ADDRESS=58 , LMODE=RS422 

TERMB CFTERM ADDRESS=59 ,LMODE=RS422 



EXIODEV 
END 



ADDRESS= 1 , MAXDCB= 1 , RSB=6 , END=YES CHANNEL 



Figure 50. Example 2: EDX Definitions 



The EDX terminal support modules shown in the figure are those required to 
support the 3101 hard copy device, $SYSPRTR. No EDX modules are required to 
support the 3101s as Communications Facility terminals. 
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Example 3: EDX Secondary SNAl Connection to a Host 

Figure 51 on page 285 shows a configuration in which a Series/ 1 is connected to 
a host computer by an SNAl connection. The Series/ 1 appears to the host as an 
SNA physical unit, two SNA type 2 logical units (terminals), one SNA type 1 
logical unit (printer), and one SNA type 3 logical unit (printer). The real devices 
are two 3277 display stations, one 4974 printer, and one 3286 printer, respectively. 



Message Flow 



To achieve the flow of messages between the Series/ 1 terminals and the host, each 
terminal or device station and its associated SNA logical unit station are linked to 
each other. When an operator enters data at the terminal represented by station 
C3277A, the 3270 control lOCP, $.IO0AC0, reads the data and sends it to 
C3277A's link, station LCFSOl. Subsequently, the SNA lOCP, $.I014E8, 
retrieves the message from LCFSOl 's queue and calls on EDX-SNA to write it to 
the SDLC Une. 

$.I014E8 also receives data from the host, and disposes of it according to the local 
address that you defined for the SNA logical unit stations. For example, data for 
logical unit 2 is intended for station LCFS02, so it is sent to that station's link, 

C3277B. 



The 3270 system consists of devices 0-2 on control unit 0. These are the 
attachment numbers that you use to determine the 3270 poUing and selection 
addresses of the terminals. Station C3271, which represents the 3271 control unit, 
is required for communication with a 3270 system even though it doesn't send or 
receive messages. 



''^.V 



Station Definitions 



Figure 52 on page 286, Figure 53 on page 287, Figure 54 on page 288, and 
Figure 55 on page 289 show the station definitions. Notice the terminal type of 
the SNA logical units in Figure 55. It must correspond to the type of station that 
the logical unit is linked to, either a real 3270 terminal or a Series/ 1 device being 
used as if it were a 3277, a 3286, or a 3287. 

Notice the logon information in Figure 55 on page 289. Three host applications 
are specified: #1 is for TSO/terminal communication, #2 is for IMS/printer 
communication, and #3 is for CICS/printer communication. An operator at the 
3277 terminal Unked to station LCFSOl is automatically connected to TSO when 
the terminal and LU station are started. 

An operator at the 3277 terminal linked to station LCFS02 is presented with a 
logon prompt screen when the terminal and LU stations are started. 
("Series/ 1-to-Host SNA lOCP, $.I014E8" on page 169 includes a picture of a 
logon screen.) The screen shows the applications specified in the PU. The 
terminal user can select option 1 to log on to TSO or option 4 to log on to any 
other SNA application defined in the host. 

The 3286 printer linked to station LCFS03 is automatically connected to CICS 
when the printer and LU stations are started. The 4974 printer linked to station 
LCFS04 is automatically connected to IMS when the printer and LU stations are 
started. IMS uses SNA type 1 logical units for printer support, so the printer 
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Host 



^\, 




i i i 



C3277A 



C3277B 



$.IO0AC0 



C3286 



C3271 



CLINE 



$.100674 



DA= 19 







BSC Multipoint 





3271 

























1 






2 


3277 




3277 




3286 



PRTR 



DA = 21 



4974 



Figure 51. Example 3: EDX Secondary SNAl Connection to a Host 



station will receive SNA character string (SCS) data. You must include LU-1 
support in $.100674 and set the printer station to SCS mode. 
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User /Message /Alias /Volume Configuration Worksheet 



System: Example 3: SNA Connection to a Host 
Node Assignment: 01 



Description 


Name 


NA 


Type 


AUas> 


SNA lOCP 


$.I014E8 


OlAA 


USER 




3270 Control lOCP 


S.IOOACO 


OlAB 


USER 




Printer lOCP 


$.100674 


OlAC 


USER 





' Specify only for alias station 



SSPOOL Storage 



2 User/Msg Stations 

Alias Stations 

Remote Stations 



-Volume Stations 



X 88 = 176 bytes 

X 40 = bytes 

X 32 = bytes 

X 104 = bytes 



Figure 52. Example 3: User/Message/AUas/Volume Configuration Workslieet 



U J 
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Device Configuration Worksheet 



System: Example 3: SNA Connection to a Host 
Node Assignment: 01 



Description 


Name 


NA 


Type 


Device Type 


Buffer 
Size 


PDS' 


Polling 
CUDA 


HI 


Bit Rate' 


Auto 
Ans' 


Printer 


PRTR 


0121 


DEVICE 


Printer 


2500 


N 


4040 


00 







' Specify only for printer device station 
^ Specify only for printer or 4978 device station 
' Specify only for 3101 or 31 OIF device station 
* Specify only for 31 OIF device station 
For 7485's, bit rate must be 9600 and AUTO ANS=NO 



S$POOL Storage 



-3 101 F Devices 



xl60 = . 



. bytes 



1 4978/Printer Device 

3101 Devices 

Remote Stations 



X 264 = 264 bytes 

X 304 = bytes 

X 32 = bytes 






Figure 53. Example 3: Device Configuration Worksheet 
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Line /Terminal /Node Configuration Worksheet 



System: Example 3: SNA Connection to a Host 
Node Assignment: 01 



o 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


BSC line to 3270 


CLINE 


0119 


LINE 


3271 


2500 









Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name* 


Polling 

CUDAV 

Portr 


Select 
CUDA' 


Control Unit 


C3271 


OlCl 


TERM 


3271 




CLINE 




407F 


0000 


Terminal 


C3277A 


01C2 


TERM 


3277 




CLINE 




4040 


6040 


Terminal 


C3277B 


01C3 


TERM 


3277 




CLINE 




40C1 


60C1 


Printer 


C3286 


01C4 


TERM 


3286 




CLINE 




40C2 


60C2 



' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
' Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
" Specify only for port terminal station 
' Specify only for DCE or DTE line station 
* Specify only for PC node station 



\J 



SSPOOL Storage 



.HDLC Lines 



1 Other Line 

4 Terminals/Nodes 

Remote Stations 



xll2 = . 



. bytes 



X 264 = 264 bytes 
X 88 = 352 bytes 
X 32 = bytes 



Figure 54. Example 3: Line/Tenninal/Node Configuration Worksheet 



O 
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SNA Configuration Worksheet 



System: Example 3: EDX Secondary SNAl Connection to a Host 
Node Assignment: 01 



PU Definition 



Description 


Name 


NA 


Type 


Buffer Size 


PU 


Host Application Host Mode 


SNA physical unit 


P028CFS 


OlOA 


PU 


2500 




#l:TSO LU2256 


#2: IMS STD32741 


#3: CICS STD32743 



LU Definitions 






Description 


Name 


NA 


Type 


Term 
Type 


PU Name 


Local 
Address 


Logon ID 


User Data 


Emulated terminal 


LCFSOl 


OlEl 


LU 


3277 


P028CFS 


1 


1 




Emulated terminal 


LCFS02 


01E2 


LU 


3277 


P028CFS 


2 






Emulated printer 


LCFS03 


01E3 


LU 


3286 


P028CFS 


3 


3 




Emulated printer 


LCFS04 


01 E4 


LU 


3287 


P028CFS 


4 


2 





Valid only for EDX Secondary SNA2 



1 Physical Unit 
4 Logical Units 
Remote Stations 



S$POOL Storage 

1 X 128 = 128 bytes 
x280= 1120 bytes 
X 32 = bytes 



F^ure 55. Example 3: SNA Configuration Worksheet 



EDX Definitions 



Figure 56 on page 290 shows the EDX definitions for example 3. You may not 
want to map the common area into all partitions, as shown in the example. The 
partition in which EDX-SNA runs need not be mapped, unless Communications 
Facility programs also run in that partition. 



Sample Configurations 289 



*** EXAMPLE 3 ^-^ 

*** '^ J^ 

$EDXDEF CSECT ^^-^ 

SYSTEM MAXPROG={10, 10, 10, 10) ,PARTS=(32,32,32,32) , X 

COMMON= ( CSXEND , CSXEND , CSXEND , CSXEND ) , X 

INITMOD=(CSXINIT) 

• 

PRINT2 TERMINAL DEVICE=4974,ADDRESS=21 ,PAGSIZE=66, X 

TOPM=0 , BOTM=65 , END=YES 
• 
BSCLINE ADDRESS=19,TYPE=MC,END=YES 3271 CONTROL 
EXIODEV ADDRESS=0A,MAXDCB=7,RSB=4,END=YES SNA 
END 

Figure 56. Example 3: EDX Definitions 



EDX Secondary SNAl and Host System Definitions 



This configuration must also be defined to EDX-SNA, to the host system access 
method (VTAM in this example), and to the host subsystem (CICS in this 
example). 

Note: The sample definitions are not compatible with every SNA environment; 
you can use them as models to develop your customized definitions. Parameters 
have not been optimized, and there may be instances of values that restrict usage 
or degrade performance. 

The examples show definitions of SNA 3274-SDLC and associated terminals to the 
network. No special parameters are needed in the network for the 
Communications Facility; you can use standard 3274 definitions. When you define 
your configuration, refer to the 3274 and SNA pubUcations listed in "About This 
Book" on page iii and to the publications for your host system and subsystem. 

Several parameters in the various definitions must agree with each other. The 
corresponding values defined in the figures in this section, the values defined to 
EDX in the EXIODEV statement (shown in the EDX definitions), and the values 
defined for Communications Facility SNA stations (shown on the SNA 
configuration worksheet) are as follows: 

Q EDX-SNA SNAPU ADDRESS and EXIODEV ADDRESS. (This 

address has also been used as the PU station network address, which is 
recommended but not required.) 

Q EDX-SNA SNAPU ENCODE and NCP/VTAM NRZI. 

Q EDX-SNA SNAPU BUFSIZ must be greater than or equal to 

NCP/VTAM MAXDATA. 

Q EDX-SNA SNAPU DCBNO, NCP/VTAM MAXOUT, and EXIODEV 

MAXDCB. 






o 
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01 EDX-SNA SNALU number, NCP/VTAM LOCADDR, and LU station 

local address. 

Q NCP VTAM MODETAB and VTAM mode table name. 

Q NCP VTAM PU ADDR and secondary station address strapped on 

SDLC attachment card. 

Q NCP/VTAM LU name and CICS NETNAME. (This name has also 

been used as the LU station name, and the NCP/VTAM PU name has 
been used as the PU station name, which is recommended but not 
required.) 

Q VTAM LOGMODE name and Communications Facility SNA 

application mode (HOST MODE). 

VTAM APPL name and Communications Facility SNA application name 
(HOST APPL). 
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NET1 CSECT , 

SNAPU RETRY=3, 

ADDRESS=OA, 

CNCTYPE=PP , 
NORING=NO, 
RATE=FULL, 
ENCODE=NRZ , 

PAD=NO , 
TODTR=0 , 
TODSR=0 , 
TOCTS=0, 
TOHLA=0 , 
THRESH=4 , 
BUFSIZ=256, 

BUFN0=4 , 
DCBN0=7, 



DEFINE THE NETWORK 

NUMBER OF I/O RETRIES X 

DEVICE ADDRESS X 

CONNECTION TYPE X 

INCLUDE RING SUPPORT X 

MODEM SPEED X 

MODEM ENCODING X 

SEND PAD CHAR ON INITIAL XMISSION X 

DATA-TERMINAL-READY TIMEOUT X 

DATA-SET-READY TIMEOUT X 

CLEAR-TO-SEND TIMEOUT X 

HOLD-LINE-ACTIVE TIMEOUT X 



MINIMUM BUFFS TO SEND RECEIVE-READY X 
SIZE OF LARGEST USER MESSAGE 



X Q 



NUMBER OF BUFFERS AT ACTIVATION 
MAXIMUM FRAMES TO SEND OR RECEIVE 



STAXID=SOOOOO ID TO SEND IN RESPONSE TO XID CMD 
SNALU LU=1, LOGICAL UNIT NUMBER X Q 



SENDBUF=1 , 
RECVBUF=1 , 
CTE=1 , 
END=NO 

SNALU LU=2, 

SENDBUF=1 , 
RECVBUF=1 , 
CTE=1 , 
END=NO 

SNALU LU=3, 

SENDBUF=1 , 
RECVBUF=1 , 
CTE=1 , 
END=NO 

SNALU LU=4, 

SENDBUF=1 , 
RECVBUF=1 , 
CTE=1 , 
END=YES 

END 



NUMBER OF SEND BUFFERS FOR LU X 
NUMBER OF RECEIVE BUFFERS FOR LU X 
NUMBER OF CORRELATION TABLE ENTRIES X 



LOGICAL UNIT NUMBER X 

NUMBER OF SEND BUFFERS FOR LU X 
NUMBER OF RECEIVE BUFFERS FOR LU X 
NUMBER OF CORRELATION TABLE ENTRIES X 



LOGICAL UNIT NUMBER X 

NUMBER OF SEND BUFFERS FOR LU X 
NUMBER OF RECEIVE BUFFERS FOR LU X 
NUMBER OF CORRELATION TABLE ENTRIES X 



LOGICAL UNIT NUMBER X 

NUMBER OF SEND BUFFERS FOR LU X 
NUMBER OF RECEIVE BUFFERS FOR LU X 
NUMBER OF CORRELATION TABLE ENTRIES X 
LAST LOGICAL UNIT TO GENERATE 









Figure 57. Example 3: EDX Secondary SNAl Definitions 



EDX Secondary SNAl Definitions 



Figure 57 shows the EDX Secondary SNAl definitions for example 3. The 
definitions support four logical units using 256-byte buffers. Only two buffers per 
logical unit are allocated; you may want more for best performance. See the EDX 
Secondary SNAl Guide for information about how buffers and related parameters 
affect performance. 



^H,aJ^ 
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Host System Definitions 



o 



Figure 58 shows the definitions of physical and logical units to the network control 
program (NCP) and VTAM. They are defined as a PU type 2 (cluster controller) 
and its associated LUs. No information about LU type is specified to the NCP. 
VTAM unformatted session services table (USSTAB) specifications are not 
included, because the Communications Facility can't use this VTAM service. The 
SNA lOCP has its own logon technique that replaces the USS screen and facilities. 
If USSTAB is specified for your system, the Communications Facility won't use it, 
but it shouldn't cause any problem. 



GCFSDLC GROUP LNCTL=SDLC, 
POLLED=YES , 
NRZI=NO 



SDLC LINE 

3274 ALWAYS POLLED 

NRZI 



LINE028 LINE ADDRESS=028, 
DISCNT=NO, 
MODETAB=CFTBL , 



LINE ADDRESS IN 3705 
VTAM ONLY OPERAND 
VTAM MODE TABLE 



DLOGMOD=LU2256, DEF LOGON MODE FROM MODETAB 

SPEED=4800, LINE SPEED (SEE NCP DOCS) 

RETRIES=(5, 1 ,20) , RECOVERY ATTEMPTS £ PAUSE 

PACING=0, PACING NOT NORMALLY USED 

VPACING=0, FOR DISPLAYS OR PRINTERS 

ISTATUS=ACTIVE LINE COMES UP WITH NCP 



X 
X 

X II 

X 
X 
X 
X 
X 






SERVICE ORDER=(P028CFS) ONLY 1 STATION HERE 

MATCH SDLC CARD STRAPPING 



CLUSTER CONTROLLER 
SEGMENT SIZE 



P028CFS 


PU 


ADDR=0 1 , 

PUTYPE=2 , 
MAXDATA=256, 

PASSLIM=7, 
MAX0UT=6 


LCFS01 


LU 


L0CADDR=1 Q 


LCFS02 


LU 


L0CADDR=2 


LCFS03 


LU 


L0CADDR=3 


LCFS04 


LU 


L0CADDR=4 



MAX CONSEC RU'S TO THIS PU 
MAX FRAMES BEFORE RESPONSE 



□ 



Figure 58. Example 3: Definitions to NCP and VTAM 



o 



Figure 59 on page 294 shows the definition of a VTAM mode table. The SNA 
appUcation modes used with the Communications Facility correspond to SNA 
session parameters that are defined in SNA bind commands. A given mode name 
refers to an image of a specific bind command stored on the host. You must define 
all modes used with the Communications FaciUty. The sample mode table includes 
entries for LU types 1, 2, and 3, as suggested in the 3274 Guide. The restriction 
the Communications Facility places on mode values is that only 24 x 80 screen 
size is supported for both default and alternate screens. For subtype 3286 and 
3287 LU3 stations, and for subtype 3278 and 3279 LU2 devices, the 
Communications Facility will accept the bind, and assume the real device can 
handle the alternate size. See the 3274 Guide for details of valid bind images. 
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CFTBL 



MODETAB 



B 



* STANDARD 3274 LU1 FROM 3274 PUBLICATION 
STD32741 MODEENT LOGMODE=STD32741 , X Q 

FMPROF=X'03' , X 

TSPROF=X'03' , X 

PRIPR0T=X'B1 ' , X 

SECPROT=X • 90 • , X 

COMPROT=X'3080' , X 

RUSIZES=X'8587' , X 
PSERVIC=X' 01 0000000000000000000000' 

* STANDARD 3274 LU3 FROM 3274 PUBLICATION 
STD32743 MODEENT LOGMODE=STD32743 , X 

FMPROF=X'03' , X 

TSPROF=X'03' , X 

PRIPR0T=X'B1 ' , X 

SECPROT=X'90' , X 

COMPROT=X'3080' , X 

RUSIZES=X'8587' , X 
PSERVIC=X' 030000000000000000000000' 

* LU2 WITH 256-BYTE RU SIZE 

LU2256 MODEENT LOGMODE=LU2256 , X 

FMPROF=X'03' , X 

TSPROF=X'03' , X 

PRIPR0T=X'B1 ' , X 

SECPROT=X'90' , X 

COMPROT=X'3080' , X 

RUSIZES=X'8585' , X 
PSERVIC=X' 020000000000000000000200' 

MODEEND 

END 

Figure 59. Example 3: VTAM Mode Table 



o 



\J 



Figure 60 shows the definition of application programs to VTAM. You must 
define all SNA application names used with the Communications Facility. 



IMS 


APPL 


AUTH= 


(ACQ, PASS) 










CICS 


APPL 


AUTH= 


:(ACQ,VPACE) 


m 








* 

TSO 


APPL 


AUTH= 


^(NOBLOCK,PASS; 


,NOPO,TSO, 


,NVPACE) 


,EAS= 


= 10 


TSO0001 


APPL 


AUTH= 


^(NOBLOCK,PASS, 


,NOPO,TSO, 


,NVPACE) 


,EAS= 




TSO0002 


APPL 


AUTH= 


^(NOBLOCK,PASS, 


,NOPO,TSO, 


,NVPACE) 


,EAS= 




TSO0003 


APPL 


AUTH= 


:(NOBLOCK,PASS, 


,NOPO,TSO, 


,NVPACE) 


,EAS= 




TSO0004 


APPL 


AUTH= 


:(NOBLOCK,PASS, 


,NOPO,TSO, 


,NVPACE) 


,EAS= 




TSO0005 


APPL 


AUTH= 


=(NOBLOCK,PASS, 


,NOPO,TSO, 


,NVPACE) 


,EAS= 




TSO0006 


APPL 


AUTH= 


=(NOBLOCK,PASS, 


,NOPO,TSO, 


,NVPACE) 


,EAS= 




TSO0007 


APPL 


AUTH= 


=(NOBLOCK,PASS, 


,NOPO,TSO, 


,NVPACE) 


,EAS= 


= 1 


TSO0008 


APPL 


AUTH= 


=(NOBLOCK,PASS, 


,NOPO,TSO, 


,NVPACE) 


,EAS= 


= 1 


TSO0009 


APPL 


AUTH= 


:(NOBLOCK,PASS 


,NOPO,TSO, 


,NVPACE) 


,EAS= 




TSO0010 


APPL 


AUTH= 


:(NOBLOCK,PASS, 


,NOPO,TSO, 


,NVPACE) 


,EAS= 


= 1 



Figure 60. Example 3: Definition of Applications to VTAM 



■\ 
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Figure 61 shows a CICS terminal control table with entries for the 
two type 2 logical units and the type 3 logical unit used in this sample 
configuration. 



LC01 DFHTCT TYPE=TERMINAL, X 

TRMTYPE=LUTYPE2 , TERMINAL X 

TRMM0DL=2 , X 

TRMIDNT=LC01 , X 

BUFFER=0 , X 

RUSIZE=256, X 

TIOAL= (256, 2048) , X 

NETNAME=LCFS01 , X 

CHNASSY=YES , X 

BRACKET=YES , X 

TRMSTAT=(TRANSCEIVE) , X 

ACCMETH=VTAM, X 

GMMSG=YES , X 
RELREQ=(YES,YES) 
* 

LC02 DFHTCT TYPE=TERMINAL, X 

TRMTYPE=LUTYPE2 , TERMINAL X 

TRMM0DL=2, X 

TRMIDNT=LC02, X 

BUFFER=0 , X 

RUSIZE=256, X 

TIOAL= (256, 2048) , X 

NETNAME=LCFS02, X 

CHNASSY=YES , X 

BRACKET=YES , X 

TRMSTAT=(TRANSCEIVE) , X 

ACCMETH=VTAM, X 

GMMSG=YES , X 
RELREQ=(YES,YES) 

* 

LC03 DFHTCT TYPE=TERMINAL, X 

TRMTYPE=LUTYPE3 , PRINTER X 

TRMM0DL=2 , X 

TRMIDNT=LC03, X 

BUFFER=0 , X 

NETNAME=LCFS03, X 

TRMSTAT=(TRANSCEIVE) , X 
ACCMETH=VTAM 

Figure 61. Example 3: CICS Terminal Control Table 
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Example 4: EDX Secondary SNA2 Connection to a Host 



Figure 62 on page 297 shows a configuration in which a Series/ 1 is connected to 
a host computer by an EDX Secondary SNA2 connection. The Series/ 1 appears to 
the host as two SNA physical units, two SNA type 2 logical units (terminals), and 
one SNA type 1 logical unit (printer). The real devices are two 4980 display 
stations and one 4974 printer. 






Message Flow 



To achieve the flow of messages between the Series/ 1 terminals and the host, each 
terminal or device station and its associated SNA logical unit station are linked to 
each other. When an operator enters data at the terminal represented by station 
T4980A, the 4978/4980 data stream lOCP, $.100670, reads the data and sends it 
to T4980A's link, station LUOIOI. Subsequently, the SNA lOCP, $.I014E8, 
retrieves the message from LUOlOl's queue and calls on EDX Secondary SNA2 to 
write it to the SDLC line. 

$.I014E8 also receives data from the host through the SDLC lines, and disposes of 
it according to the local address and PU that you defined for the SNA logical unit 
stations. For example, data for logical unit 2 on the SDLC line with device address 
X'OA', is intended for station LU0102, so it is sent to that station's link, T4980B. 



Station Definitions 



Figure 63 on page 298, Figure 64 on page 299, and Figure 65 on page 300 
show the station definitions. 

Notice the terminal type of the SNA logical units in Figure 65 on page 300. It 
must correspond to the type of station that the logical unit is Unked to, either a real 
3270 terminal or a Series/ 1 device being used as if it were a 3277, a 3286, or a 
3287.- 



'Jl jv 



Notice the PU definitions in Figure 65 on page 300. The PU number specified in 
each station must correspond to the PU defined to EDX Secondary SNA2 for that 
station. For example, SNA PUs 1 and 2 defined in Figure 67 on page 303 
become PUOl and PU02 respectively. 

Notice also the logon information in Figure 65 on page 300. Three host 
applications are specified: #1 is for TSO/terminal communication, #2 is for 
IMS/printer communication, and #3 is for CICS/printer communication. An 
operator at the 4980 display device linked to station LUOlOl is automatically 
connected to TSO when the terminal and LU station are started. 



An operator at the 4980 display device linked to station LU0102 is presented with 
a logon prompt screen when the terminal and LU stations are started. 
("Series/ 1-to-Host SNA lOCP, $.I014E8" on page 169 includes a picture of a 
logon screen.) The screen shows the applications specified in the PU. The 
terminal user can select option 1 to log on to TSO or option 4 to log on to any 
other SNA appUcation defined in the host. 

The 4974 printer linked to station LU0102 is automatically connected to IMS when 
the printer and LU stations are started. IMS uses SNA type 1 logical units for 
printer support, so the printer station will receive SNA character string (SCS) data. 



o 
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Host 




I t 



T4980A T4980B 



$.100670 



$.100674 



PRTR 



DA =80 DA =81 



4980 



4980 



DA = 21 



4974 



Figure 62. Example 4: EDX Secondary SNA2 Connection to a Host 



You must include LU-1 support in $.100674 and set the printer station to SCS 
mode. 



o 
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User I Message /Alias /Volume Configuration Worksheet 



System: Example 4: EDX Secondary SNA2 Connection to a Host 
Node Assignment: 01 






Description 


Name 


NA 


Type 


AUas' 


SNA lOCP 


$.I014E8 


01 AA 


USER 




4978/4980 Data Stream lOCP 


$.100670 


OlAB 


USER 




Printer lOCP 


$.100674 


OlAC 


USER 





' Specify only for alias station 



S$POOL Storage 



2 User/Msg Stations 

Alias Stations 

Remote Stations 



-Volume Stations 



x88= 176 bytes 

X 40 = bytes 

X 32 = bytes 

X 104 = bytes 



Figure 63. Example 4: User/Message/ Alias/Volume Configuration Worksheet 
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Device Configuration Worksheet 



System: Example 4: EDX Secondary SNA2 Connection to a Host 
Node Assignment: 01 



Description 


Name 


NA 


Type 


Device Type 


Buffer 
Size 


PDS' 


Polling 
CUDA 


Selection 
CUDAV 
HDCPY' 


Bit Rate' 


Auto 
Ans' 


Printer 


PRTR 


0121 


DEVICE 


Printer 


2500 


N 


4040 


0000 






4980 


T4980A 


0180 


DEVICE 


4978 


2500 




4040 


0000 






4980 


T4980B 


0181 


DEVICE 


4978 


2500 




4040 


0000 







' Specify only for printer device station 
^ Specify only for printer or 4978 device station 
' Specify only for 3101 or 3101 F device station 
" Specify only for 31 OIF device station 
For 7485's, bit rate must be 9600 and AUTO ANS=NO 



S$POOL Storage 



.3 101 F Devices 



xl60 = 



. bytes 



1 4978/Printer Device 

3101 Devices 

Remote Stations 

Figure 64. Example 4: Device Configuration Worksheet 



X 264 = 264 bytes 

X 304 = bytes 

X 32 = bytes 



o 
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SNA Configuration Worksheet 



System: Example 4: EDX Secondary SNA2 Connection to a Host 
Node Assignment: 01 



PU Definition 



Description 


Name 


NA 


Type 


Buffer Size 


PU 


Host Application 


Host Mode 


SNA physical unit 


PUOl 


OlOA 


PU 


2500 


1 


#1:TS0 


LU2256 


#2: IMS 


STD32741 


#3: CICS 


STD32743 


SNA physical unit 


PU02 


0108 


PU 


2500 


2 


#l:TSO 


LU2256 


#2: IMS 


STD3274I 


#3: CICS 


STD32743 



LU Definitions 



Description 


Name 


NA 


Type 


Term 
Type 


PU Name 


Local 
Address 


Logon ID 


User Data 


Emulated terminal 


LUOlOl 


OlEl 


LU 


3277 


PUOl 


1 


1 




Emulated terminal 


LU0102 


01 E2 


LU 


3277 


PUOl 


2 






Emulated printer 


LU0201 


01E4 


LU 


3287 


PU02 


1 


2 








' Valid only for EDX Secondary SNA2 



1 Physical Unit 
4 Logical Units 
Remote Stations 



SSPOOL Storage 

1 X 128 = 128 bytes 
X 120 = 480 bytes 
X 32 = bytes 



I Figure 65. Example 4: SNA Configuration Worksheet 



EDX Definitions 



Figure 66 on page 301 shows the EDX definitions for example 4. You may not 
want to map the common area into all partitions, as shown in the example. The 
partition in which EDX-SNA runs does not need to be mapped, unless 
Communications Facility programs also run in that partition. 



^t.aJl'^ 
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*** EXAMPLE 4 
*** 

$EDXDEF 



CSECT 

SYSTEM MAXPROG=(10, 10,10,10) , PARTS= ( 32 , 32 , 32 , 32 ) , 

COMMON= ( CSXEND , CSXEND , CSXEND , CSXEND) , 

INITMOD= (CSXINIT) 



PRINT2 TERMINAL DEVICE=4974 , ADDRESS=21 , PAGSIZE=66 , 
TOPM=0 , BOTM=65 , END=YES 

• 

BSCLINE ADDRESS=19,TYPE=MC,END=YES 3271 CONTROL 

EXIODEV ADDRESS=0A,MAXDCB=7,RSB=4,END=NO SNA 

EXIODEV ADDRESS=08,MAXDCB=7,RSB=4,END=YES SNA 
END 



Figure 66. Example 4: EDX Definitions 



EDX Secondary SNA2 and Host System Definitions 






This configuration must also be defined to EDX Secondary SNA2, to the host 
system access method (VTAM in this example), and to the host subsystem (CICS 
in this example). 

Note: The sample definitions are not compatible with every SNA environment; 
you can use them as models to develop your customized definitions. Parameters 
have not been optimized, and there may be instances of values that restrict usage 
or degrade performance. 

The examples show definitions of SNA 3274-SDLC and associated terminals to the 
network. No special parameters are needed in the network for the 
Communications Facility; you can use standard 3274 definitions. When you define 
your configuration, refer to the 3274 and SNA publications listed in "About This 
Book" on page iii and to the pubUcations for your host system and subsystem. 

Several parameters in the various definitions must agree with each other. The 
corresponding values defined in the figures in this section, the values defined to 
EDX in the EXIODEV statement (shown in the EDX definitions), and the values 
defined for Communications Facility SNA stations (shown on the SNA 
configuration worksheet) are as follows: 

D EDX-SNA SNAPU ADDRESS and EXIODEV ADDRESS. (This 

address has also been used as the PU station network address, which is 
recommended but not required.) 

Q EDX-SNA SNAPU ENCODE and NCP/VTAM NRZI. 

Q EDX-SNA SNAPU BUFSIZ must be greater than or equal to 

NCP/VTAM MAXDATA. 






EDX-SNA SNAPU DCBNO, NCP/VTAM MAXOUT, and EXIODEV 
MAXDCB. 



Sample Configurations 301 



Q EDX-SNA SNALU number, NCP/VTAM LOCADDR, and LU station 

local address. 

Q NCP VTAM MODETAB and VTAM mode table name. 

Q NCP VTAM PU ADDR and secondary station address strapped on 

SDLC attachment card. 

Q NCP/VTAM LU name and CICS NETNAME. 

Q VTAM LOGMODE name and Communications Facility SNA 

application mode (HOST MODE). 

VTAM APPL name and Communications Facility SNA application name 
(HOST APPL). 

EDX SNA PU number and the PU station's PU number. (NETl and 
NET2 indicate that these SNA definitions are for PUs 1 and 2, 
respectively.) 



c 
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302 eommunications Facility Design and Installation Guide 



\ 






NET1 CSECT, 

SNAPU RETRY=3, 

ADDRESS=OA, 

CNCTYPE=PP, 
NORING=NO , 
RATE=FULL , 
ENCODE=NRZ , 

PAD=NO, 
TODTR=0 , 
TODSR=0 , 
TOCTS=0, 
TOHLA=0 , 
THRESH=4 , 
BUFSIZ=256, 

BUFN0=4 , 
DCBN0=7 , 



DEFINE THE NETWORK 

NUMBER OF I/O RETRIES X 

DEVICE ADDRESS X 

CONNECTION TYPE 5t 

INCLUDE RING SUPPORT X 

MODEM SPEED X 

MODEM ENCODING X 

SEND PAD CHAR ON INITIAL XMISSION X 

DATA-TERMINAL-READY TIMEOUT X 

DATA-SET-READY TIMEOUT X 

CLEAR-TO-SEND TIMEOUT X 

HOLD-LINE-ACTIVE TIMEOUT X 
MINIMUM BUFFS TO SEND RECEIVE-READY X 



SIZE OF LARGEST USER MESSAGE 

NUMBER OF BUFFERS AT ACTIVATION 
MAXIMUM FRAMES TO SEND OR RECEIVE 



STAXID=SOOOOO ID TO SEND IN RESPONSE TO XID CMD 



SNALU LU=1 , 

SENDBUF=1 , 
RECVBUF=1 , 
CTE= 1 , 
END=NO 

SNALU LU=2, 

SENDBUF=1 , 
RECVBUF=1 , 
CTE=1 , 
END=NO 

SNALU LU=3, 

SENDBUF=1 , 
RECVBUF=1 , 
CTE=1 , 
END=NO 

SNALU LU=4, 

SENDBUF=1 , 
RECVBUF= 1 , 
CTE=1 , 
END=YES 

END 



LOGICAL UNIT NUMBER 



Figure 67. Example 4: EDX Secondary SNA2 Definitions 



X 



NUMBER OF SEND BUFFERS FOR LU X 
NUMBER OF RECEIVE BUFFERS FOR LU X 
NUMBER OF CORRELATION TABLE ENTRIES X 



LOGICAL UNIT NUMBER X 

NUMBER OF SEND BUFFERS FOR LU X 
NUMBER OF RECEIVE BUFFERS FOR LU X 
NUMBER OF CORRELATION TABLE ENTRIES X 



LOGICAL UNIT NUMBER X 

NUMBER OF SEND BUFFERS FOR LU X 
NUMBER OF RECEIVE BUFFERS FOR LU X 
NUMBER OF CORRELATION TABLE ENTRIES X 



LOGICAL UNIT NUMBER X 

NUMBER OF SEND BUFFERS FOR LU X 
NUMBER OF RECEIVE BUFFERS FOR LU X 
NUMBER OF CORRELATION TABLE ENTRIES X 
LAST LOGICAL UNIT TO GENERATE 
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NET2 CSECT, 

SNAPU RETRY=3, 

ADDRESS=08, 

CNCTYPE=PP , 
NORING=NO , 
RATE=FULL, 
ENCODE=NRZ , 

PAD=NO , 
TODTR=0 , 
TODSR=0 , 
TOCTS=0, 
TOHLA=0 , 
THRESH=4 , 
BUFSIZ=256, 

BUFPOOL=YES , 
STKNUM=5 , 
SBUFN0=4 

BUFN0=4 , 
DCBN0=7, 



DEFINE THE NETWORK 

NUMBER OF I/O RETRIES X 

DEVICE ADDRESS X 

CONNECTION TYPE X 

INCLUDE RING SUPPORT X 

MODEM SPEED X 

MODEM ENCODING X 

SEND PAD CHAR ON INITIAL XMISSION X 

DATA-TERMINAL-READY TIMEOUT X 

DATA-SET-READY TIMEOUT X 

CLEAR-TO-SEND TIMEOUT X 

HOLD-LINE-ACTIVE TIMEOUT X 



MINIMUM BUFFS TO SEND RECEIVE-READY X 
SIZE OF LARGEST USER MESSAGE 



BUFFER POOLING 

NUMBER OF STACKS FOR LUS 

CONCURRENT SEND BUFFERS 

NUMBER OF BUFFERS AT ACTIVATION 
MAXIMUM FRAMES TO SEND OR RECEIVE 



X Q 



STAXID=SOOOOO,ID TO SEND IN RESPONSE TO XID CMD 

SNALU LU=1, LOGICAL UNIT NUMBER X 

SENDBUF=1 , NUMBER OF SEND BUFFERS FOR LU X 

RECVBUF=1 , NUMBER OF RECEIVE BUFFERS FOR LU X 

CTE=1 , NUMBER OF CORRELATION TABLE ENTRIES X 

HOLDBND=YES, HOLD BIND UNTIL NETINIT ISSUED X 
END=NO 



SNALU LU=2, 

SENDBUF= 1 , 
RECVBUF=1 , 
CTE=1 , 
END=YES 

END 



LOGICAL UNIT NUMBER X 

NUMBER OF SEND BUFFERS FOR LU X 
NUMBER OF RECEIVE BUFFERS FOR LU X 
NUMBER OF CORRELATION TABLE ENTRIES X 






Figure 68. Example 4: EDX Secondary SNA2 Definitions 



EDX Secondary SNA2 Definitions 



Figure 67 on page 303 and Figure 68 show the EDX Secondary SNA2 definitions 
for example 4. The definitions support four logical units using 256-byte buffers. 
Only two buffers per logical unit are allocated; you may want more for best 
performance. See the EDX Secondary SNA2 Guide for information about how 
buffers and related parameters affect performance. 
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Host System Definitions 



o 



Figure 69 and Figure 70 on page 306 show the definitions of physical and logical 
units to the network control program (NCP) and VTAM. They are defined as a 
PU type 2 (cluster controller) and its associated LUs. No information about LU 
type is specified to the NCP. VTAM unformatted session services table 
(USSTAB) specifications are not included, because the Communications Facility 
can't use this VTAM service. The SNA lOCP has its own logon technique that 
replaces the USS screen and facilities. If USSTAB is specified for your system, the 
Communications Facility won't use it, but it shouldn't cause any problem. 



GCFSDLC1 GROUP LNCTL=SDLC, 
POLLED=YES , 
NRZI=NO 



SDLC LINE 

3274 ALWAYS POLLED 

NRZI 



LINE037 LINE ADDRESS=037, 
DISCNT=NO, 
MODETAB=CFTBL , 



LINE ADDRESS IN 3705 
VTAM ONLY OPERAND 
VTAM MODE TABLE 



DLOGMOD=TS032742, DEE LOGON MODE FROM MODETAB X 

SPEED=4800, LINE SPEED (SEE NCP DOCS) X 

RETRIES=(5,1 ,20) , RECOVERY ATTEMPTS £ PAUSE X 

PACING=0, PACING NOT NORMALLY USED X 

VPACING=0, FOR DISPLAYS OR PRINTERS X 

ISTATUS=ACTIVE LINE COMES UP WITH NCP 






SERVICE ORDER=(P037CFS) ONLY 1 STATION HERE 

MATCH SDLC CARD STRAPPING 



CLUSTER CONTROLLER 
SEGMENT SIZE 



P028CFS 


PU 


ADDR=0D, 

PUTYPE=2, 
MAXDATA=1024, 

PASSLIM=55, 
MAX0UT=7 


* 
L37S01 


LU 


L0CADDR=1 Q 


L37S02 


LU 


L0CADDR=2 


L37S03 


LU 


L0CADDR=3 


L37S04 


LU 


L0CADDR=4 



X 

X II 



MAX CONSEC RU'S TO THIS PU 
MAX FRAMES BEFORE RESPONSE 



o 



Figure 69. Example 4: Definitions to NCP and VTAM 
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GCFSDLC1 GROUP LNCTL=SDLC, 
POLLED=YES , 
NRZI=NO 



SDLC LINE 

3274 ALWAYS POLLED 

NRZI 






LINE037 LINE ADDRESS=037, 
DISCNT=NO, 
MODETAB=CFTBL, 



LINE ADDRESS IN 3705 
VTAM ONLY OPERAND 
VTAM MODE TABLE 



DLOGMOD=TS032742, DEF LOGON MODE FROM MODETAB 

SPEED=4800, LINE SPEED (SEE NOP DOCS) 

RETRIES=(5, 1 ,20) , RECOVERY ATTEMPTS & PAUSE 

PACING=0, PACING NOT NORMALLY USED 

VPACING=0, FOR DISPLAYS OR PRINTERS 

ISTATUS=ACTIVE LINE COMES UP WITH NCP 

SERVICE ORDER=(P037CFS) ONLY 1 STATION HERE 



P028CFS 


PU 


ADDR=0D, 
PUTYPE=2 , 




MATCH SDLC CARD STRAPPING 
CLUSTER CONTROLLER 


X 
X 


H 






MAXDATA=1024, 




SEGMENT SIZE 


X 


El 






PASSLIM=55, 




MAX CONSEC RU'S TO THIS PU 


X 








MAX0UT=7 




MAX FRAMES BEFORE RESPONSE 




□ 


* 

L37S01 


LU 


L0CADDR=1 Q 


11 








L37S02 


LU 


L0CADDR=2 











Figure 70. Example 4: Definitions to NCP and VTAM 



Figure 71 on page 307 shows the definition of a VTAM mode table. The SNA 
application modes used with the Communications Facility correspond to SNA 
session parameters that are defined in SNA bind commands. A given mode name 
refers to an image of a specific bind command stored on the host. You must define 
all modes used with the Communications Facility. The sample mode table includes 
entries for LU types 1, 2, and 3, as suggested in the 3274 Guide. The restriction 
the Communications Facility places on mode values is that only 24 by 80 screen 
size is supported for both default and alternate screens. For subtype 3286 and 
3287 LU3 stations, and for subtype 3278 and 3279 LU2 devices, the 
Communications Facility will accept the bind, and assume that the real device can 
handle the alternate size. See the 32 74 Guide for details of valid bind images. 
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CFTBL 



MODETAB 



B 






* STANDARD 3274 LU1 FROM 3274 PUBLICATION 
STD32741 MODEENT LOGMODE=STD32741 , X Q 

FMPROF=X'03' , X 

TSPROF=X'03' , X 

PRIPR0T=X'B1 • , X 

SECPROT=X'90' , X 

COMPROT=X'3080' , X 

RUSIZES=X'8587' , X 
PSERVIC=X' 010000000000000000000000' 

* STANDARD 3274 LU3 FROM 3274 PUBLICATION 
STD32743 MODEENT LOGMODE=STD32743 , X 

FMPROF=X'03' , X 

TSPROF=X'03' , X 

PRIPR0T=X'B1 ' , X 

SECPROT=X ' 90 ' , X 

COMPROT=X'3080' , X 

RUSIZES=X'8587' , X 
PSERVIC=X' 030000000000000000000000' 

* LU2 WITH 256-BYTE RU SIZE 

LU2256 MODEENT LOGMODE=LU2256 , X 

FMPROF=X'03' , X 

TSPROF=X'03' , X 

PRIPR0T=X'B1 ' , X 

SECPROT=X ' 90 ' , X 

COMPROT=X'30^0' , X 

RUSIZES=X'8585' , X 
PSERVIC=X ' 020000000000000000000200 ' 

MODEEND 

END 

Figure 71. Example 4: VTAM Mode Table 



Figure 72 shows the definition of application programs to VTAM. You must 
define all SNA appUcation names used with the Communications Facility. 



IMS 
CICS 



APPL AUTH= ( ACQ , PASS ) 
APPL AUTH= ( ACQ , VPACE ) 



TSO 

TSO0001 

TSO0002 

TSO0003 

TSO0004 

TSO0005 

TSO0006 

TSO0007 

TSO0008 

TSO0009 

TSO0010 



APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 



AUTH= 
AUTH= 
AUTH= 
AUTH= 
AUTH= 
AUTH= 
AUTH= 
AUTH= 
AUTH= 
AUTH= 
AUTH= 



(NOBLOCK, 
(NOBLOCK, 
(NOBLOCK, 
(NOBLOCK, 
(NOBLOCK, 
(NOBLOCK, 
(NOBLOCK, 
(NOBLOCK, 
(NOBLOCK, 
(NOBLOCK, 
(NOBLOCK, 



PASS, 
PASS^ 
PASS, 
PASS, 
PASS, 
PASS, 
PASS, 
PASS, 
PASS, 
PASS, 
PASS, 



NOPO, 
NOPO^ 
NOPO, 
NOPO, 
NOPO, 
NOPO, 
NOPO, 
NOPO, 
NOPO, 
NOPO, 
NOPO, 



TSO, 
TSOt 
TSO, 
TSO, 
TSO, 
TSO, 
TSO, 
TSO, 
TSO, 
TSO, 
TSO, 



NVPACE) 
NVP_ACE) 
NVPACE) 
NVPACE) 
NVPACE) 
NVPACE) 
NVPACE) 
NVPACE) 
NVPACE) 
NVPACE) 
NVPACE) 



,EAS=10 

,EAS=1 

,EAS=1 

,EAS=1 

,EAS=1 

,EAS=1 

,EAS=1 

,EAS=1 

,EAS=1 

,EAS=1 

,EAS=1 



F^ure 72. Example 4: Definition of Applications to VTAM 
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Figure 73 on page 308 shows a CICS terminal control table with entries for the 
two type 2 logical units used in this sample configuration. 



LC01 



* 

LC02 



* 
* 

LC03 



DFHTCT TYPE=TERMINAL , 

TRMTYPE=LUTYPE2 , TERMINAL 

TRMM0DL=2 , 

TRMIDNT=LC01 , 

BUFFER=0 , 

RUSIZE=256, 

TIOAL= (256, 2048) , 

NETNAME=LCFS01 , 

CHNASSY=YES, 
BRACKET=YES , 
TRMSTAT=(TRANSCEIVE) , 
ACCMETH=VTAM , 
GMMSG=YES , 
RELREQ=(YES,YES) 

DFHTCT TYPE=TERMINAL, 

TRMTYPE=LUTYPE2 , TERMINAL 

TRMM0DL=2 , 

TRMIDNT=LC02, 

BUFFER=0 , 

RUSIZE=256, 

TIOAL= (256, 2048) , 

NETNAME=LCFS02, 

CHNASSY=YES, 

BRACKET=YES , 

TRMS T AT= ( TRANS CE I VE ) , 

ACCMETH=VTAM, 

GMMSG=YES , 

RELREQ=(YES,YES) 



DFHTCT TYPE=TERMINAL, 

TRMTYPE=LUTYPE2 , TERMINAL 

TRMM0DL=2, 

TRMIDNT=LC03, 

BUFFER=0, 

RUSIZE=256, 

TIOAL= (256, 2048) , 

NETNAME=LCFS03, 

CHNASSY=YES, 

BRACKET=YES , 

TRMSTAT=(TRANSCEIVE) , 

ACCMETH=VTAM, 

GMMSG=YES, 

RELREQ=(YES,YES) 



\J 






F^ure 73. Example 4: CICS Terminal Control Table 
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Example 5: Local Communications Controller Connection between 
Series/ Is 

Figure 74 on page 311 shows a configuration in which three Series/ Is are 
attached to a Local Communications Controller. The appUcation program in node 
1 communicates with users at 3101 terminals in any of the three nodes. The 3101 
terminals are attached to the Series/ Is by feature programmable adapters. 



/'i^"^ 
O 



Message Flow 



To achieve the flow of messages between the terminals in node 1 and the 
application program, the device stations are linked to the program station. There 
can't be a Unk from the program station to the device stations, since a station can 
be linked to only one station. A program that communicates with multiple users 
must be written to respond to a user by sending a message to the station from 
which it received a message. Sample program $.CFMENU, which is described in 
the Programmer's Guide, illustrates this kind of coding. 

To understand the flow of messages between the terminals in nodes 2 and 3 and 
the application program in node 1, first look at the station definition worksheets for 
the three nodes. Notice that each node has a unique node assignment. 

In node 1 , all stations that the appHcation program will communicate with are 
defined on the device configuration worksheet; the network address distinguishes 
the local 3101s from the remote 3101s. If you prefer, you can define the remote 
3 101s as MSG stations. When a remote station is started, a vector station block is 
created; it contains only the station's name, network address, and link. 

In nodes 2 and 3, the remote application program is defined on the 
user/message/alias configuration worksheet; its network address identifies it as a 
remote station. 



/if \ 



In all three nodes, the remote nodes to which messages will be sent are defined on 
the line/terminal/node configuration worksheet. Notice the network addresses on 
those worksheets. The second byte of the line station network address is irrelevant 
(so long as it is unique within the node). It is the device address that specifies the 
Local Communications Controller subchannel address. The second byte of the 
node station network addresses must be 00. As defined, nodes 2 and 3 can't 
communicate with each other. To make that communication possible, define node 
3 in node 2 and vice versa. 

When these stations have been defined, linked as shown in the diagram of the 
configuration, and started, a display of the active stations in node 2 will show this 
information: 



STATION 


TYPE 


NA 


LINK 


$.DISP 


0000 


0200 


0000 


LCCDEV 


OABO 


02C0 


0000 


N0DE1 


1040 


0100 


0000 


TERM2A 


0630 


0210 


01AC 


TERM2B 


0630 


0220 


01AC 


APROG 


0800 


01AC 


0000 



\j^ 
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3101 



3101 






DA = 60 



DA = 61 



Series/ 1, Node 1 



$.IO06F0 



TERMIA 



TERM IB 



APROG 



I 

TERM2A 
I I 

TERM2B 
I I 

TERM3A , 
I I 

TERM3B . 
I I 







Sen 


es/1, Node 2 




/ DA = 


50 




DA = 60 




$.IO0AB0 


LCCDEV 










NODEl 










3101 


_. 




TERM2A 


APROG 


DA = 61 






TERM2B 


3101 










$IO06F0 










DA 


= 50 \ 




Series/ 1, Node 3 








LCCDEV 


$.IO0AB0 




DA = 60 




NODEl 




















3101 


r -r-- 

APROG 

1 -U-. 


TERM3A 


DA = 61 




TERM3B 




3101 












$IO06F0 







Figure 74. Example 5: Local Communications Controller Connection between Series/ Is 
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Notice the following: 

• The network address of $.DISP (the system station) shows that the node ^-^^^ 
assignment is 02. This is the result of issuing a CP SET NODE command. (J ^ 

• The remote program station (APROG) has a vector station block (type 08). 
This is the result of starting a station whose type is other than NODE and 
whose network address is not in this node. 

Now let's see how a message from TERM2A gets routed to the application 
program in node 1. As always, the I/O control program sends the message to the 
origin station's link, APROG, whose network address is OlAC. The message 
dispatcher determines that the address is not in this node, sets the second byte to 
00, and looks for a station with that network address (0100). Station NODEl 
satisfies the search, so the message dispatcher puts the message on NODEl's 
queue. 

The method of routing messages between nodes accounts for the restriction that 
you can't have more than one active BSC point-to-point connection, Local 
Communications Controller connection, or X.25 connection through circuit 
stations with usage CF between two Series/ Is. For all these connections, a station 
with network address ««00 is required to route messages to node nn, and you can't 
start more than one station with a given network address. 

Subsequently, the Local Communications Controller lOCP, $.100 ABO, retrieves 

the message from NODEl's queue and sends it over to the Local Communications 

Controller ring managed by the associated line station, LCCDEV. The ring 

address determines which node receives the message. In this case, station NODEl 

has ring address 2F, so $.IO0AB0 in node 1 receives the message. $.IO0AB0 /f~~^, 

sends the message to the message dispatcher. The message carries its original ^ j) 

routing information showing that the origin is 0210 and the destination is OlAC. 

The message dispatcher determines that the destination network address is in this 

node, so it puts the message on APROG's queue. The response from APROG to 

TERM2A is routed in a similar manner. 

In summary, to enable communication between nodes on a Local Communications 
Controller, you must: 

• Give each node a unique node assignment. 

• In each node, define the remote stations to which local stations will send 
messages. Be sure that the network address is the same as that of the 
corresponding real station in the remote node. The station names need not be 
the same. 

• In each node, define a NODE station for each node to which local stations will 
send messages. 

• When you start the Communications Facility, issue a CP SET NODE 
command to set the node assignment before starting any remote stations. 



^kitoj.o'^ 
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Figure 75 through Figure 83 on page 319 show the station definitions for the 
three nodes in this configuration. 



\J 



User/ Message /Alias /Volume Configuration Worksheet 



System: Example 5: Local Communications Controller, Node 1 
Node Assignment: 01 



Description 


Name 


NA 


Type 


Alias' 


3101-MFA/FPCAIOCP 


$.IO06F0 


OlAA 


USER 




Local Communications Controller lOCP 


S.IOOABO 


OlAB 


USER 




Application program 


APROG 


OlAC 


USER 





Specify only for alias station 



SSPGOL Storage 






3 User/Msg Stations 

Alias Stations 

Remote Stations 

Volume Stations 



X 88 = 264 bytes 

X 40 = bytes 

X 32 = bytes 

X 104 = bytes 



Figure 75. Example 5: Node 1 User/Message/AKas/Volume Configuration Worksheet 
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Device Configuration Worksheet 






System: Example 5: Local Communications Controller, Node 1 
Node Assignment: 01 



Description 


Name 


NA 


Type 


Device 
Type 


Buffer 
Size 


PDS' 


PoUing 
CUDA 


Selection CUDAV 
HDCPY' 


Bit Rate' 


Auto 
Ans' 


3101 


TERMIA 


0110 


DEVICE 


3101F 


2500 




4040 


SSYSFRTR 


9600 


N 


3101 


TERM IB 


0120 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


9600 


N 


Remote 3101 


TERM2A 


0210 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


9600 


N 


Remote 3101 


TERM2B 


0220 


DEVICE 


3101F 


2500 




4040 


$SYSPRTR 


9600 


N 


Remote 3101 


TERM3A 


0310 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


9600 


N 


Remote 3101 


TERM3B 


0320 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


9600 


N 



' Specify only for printer device station 
^ Specify only for printer or 4978 device station 
' Specify only for 3101 or 3 101 F device station 
" Specify only for 31 OIF device station 
For 7485s, bit rate must be 9600 and AUTO ANS=NO 



S$POOL Storage 



.31 OIF Devices 



2 3101 Devices 
4 Remote Stations 



xl60 = 



_4978/Printer Devices x 264 = 



bytes 
bytes 






X 304 = 608 bytes 
x32= 128 bytes 



Figure 76. Example 5: Node 1 Device Configuration Worksheet 
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Line I Terminal I Node Configuration Worksheet 



System: Example 5: Local Communications Controller, Node 1 
Node Assignment: 01 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


Local Communications 
Controller ring 


LCCDEV 


OICO 


LINE 


LCC 


2500 


50 







Terminal and Node Definitions 






Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name* 


Polling 

CUDAV 

Portr 


Select 
CUDA' 


Node 2 


NODE2 


0200 


NODE 


CF 


4F 


LCCDEV 








Node 3 


NODE3 


0300 


NODE 


CF 


IF 


LCCDEV 









' specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
* Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 



S$POOL Storage 



.HDLC Lines 



1 Other Line 

2 Terminals/Nodes 
Remote Stations 



xll2 = . 



bytes 



X 264 = 264 bytes 
X 88 = 176 bytes 
X 32 = bytes 



^P^ 



Figure 77. Example 5: Node 1 Line/Tenninal/Node Conf^vration Worksheet 
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User /Message /Alias /Volume Configuration Worksheet 



System: Example 5: Local Communications Controller, Node 2 
Node Assignment: 02 






Description 


Name 


NA 


Type 


Alias' 


3101-MFA/FPCAIOCP 


$.IO06F0 


02AA 


USER 




Local Communications Controller lOCP 


S.IOOABO 


02AB 


USER 




Remote application program 


APROG 


OlAC 


USER 





Specify only for alias station 



S$POOL Storage 



2 User/Msg Stations 

Alias Stations 

1 Remote Station 
Volume Stations 



x88= 176 bytes 

X 40 = bytes 

X 32 = 32 bytes 

X 104 = bytes 



Figure 78. Example 5: Node 2 User/Message/ Alias/ Volume Configuration Worksheet 



Device Configuration Worksheet 



\J 



System: Example 5: Local Communications Controller, Node 2 
Node Assignment: 02 



Description 


Name 


NA 


Type 


Device 
Type 


Buffer 
Size 


PDS" 


Polling 
CUDA 


Selection CUDAV 
HDCPY' 


Bit Rate' 


Auto 
Ans' 


3101 


TERM2A 


0210 


DEVICE 


3101 


2500 




4040 


SSYSPRTR 






3101 


TERM2B 


0220 


DEVICE 


3101 


2500 




4040 


SSYSPRTR 







' Specify only for printer device station 
^ Specify only for printer or 4978 device station 
' Specify only for 3101 or 3 101 F device station 
'' Specify only for 3 101 F device station 
For 7485s, bit rate must be 9600 and AUTO ANS=NO 



SSPOOL Storage 



-3101F Devices x 160 

_4978/Printer Devices x 264 



bytes 
bytes 



2 3101 Devices 
Remote Stations 



X 304 = 608 bytes 
X 32 = bytes 



Figure 79. Example 5: Node 2 Device Configuration Worksheet 



^k^MBiJ^ 
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Line /Terminal I Node Configuration Worksheet 



System: Example 5: Local Communications Controller, Node 2 
Node Assignment: 02 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


Local Communications 
Controller ring 


LCCDEV 


02C0 


LINE 


LCC 


2500 


50 







Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name' 


Polling 

CUDAV 

Portr 


Select 
CUDA' 


Nodel 


NODEl 


0100 


NODE 


CF 


2F 


LCCDEV 









' specify only for Local Communications Controller or 

Series/ 1-PC Connect Attachment line stations 
' Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
* Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 



SSPOOL Storage 



-HDLC Lines 



1 Other Line 
1 Terminal/Node 
Remote Stations 



xll2 = . 



bytes 



X 264 = 264 bytes 

X 88 = 88 bytes 

X 32 = bytes 



o 



Figure 80. Example 5: Node 2 Line/Terminal/Node Configuration Worksheet 
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User /Message /Alias /Volume Configuration Worksheet 



System: Example 5: Local Communications Controller Node 3 
Node Assignment: 03 






Description 


Name 


NA 


Type 


Alias' 


3101-MFA/FPCAIOCP 


$.IO06F0 


03AA 


USER 




Local Communications Controller lOCP 


S.IOOABO 


03AB 


USER 




Remote application program 


APROG 


OlAC 


USER 





Specify only for alias station 



SSPOOL Storage 



2 User/Msg Stations 

Alias Stations 

1 Remote Station 
Volume Stations 



x88 = 176 bytes 

X 40 = bytes 

X 32 = 32 bytes 

X 104 = bytes 



Figure 81. Example 5: Node 3 User/Message/ Alias/ Volume Configuration Worksheet 



Device Configuration Worksheet 






System: Example 5: Local Communications Controller Node 3 
Node Assignment: 03 



Description 


Name 


NA 


Type 


Device 
Type 


Buffer 
Size 


PDS' 


Polling 
CUDA 


Selection CUDAV 
HDCPY' 


Bit Rate' 


Auto 
Ans' 


3101 


TERM3A 


0310 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


9600 


N 


3101 


TERM3B 


0320 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


9600 


N 



' Specify only for printer device station 
^ Specify only for printer or 4978 device station 
' Specify only for 3101 or 3 101 F device station 
•* Specify only for 3 101 F device station 
For 7485s, bit rate must be 9600 and AUTO ANS=NO 



SSPOOL Storage 



_31 OIF Devices 
_4978/Printer Devices 



X 160 = . 
X 264 = , 



. bytes 
. bytes 



2 3101 Devices 
Remote Stations 

Figure 82. Example 5: Node 3 Device Configuration Worksheet 



X 304 = 608 bytes 
X 32 = bytes 



\j) 
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Line /Terminal /Node Configuration Worksheet 



System: Example 5: Local Communications Controller, Node 3 
Node Assignment: 03 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


Local Communications 
Controller ring 


LCCDEV 


03C0 


LINE 


LCC 


2500 


50 







Terminal and Node Definitions 






Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name* 


Polling 

CUDAV 

Portr 


Select 
CUDA' 


Nodel 


NODEl 


0100 


NODE 


CF 


2F 


LCCDEV 









' specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
" Specify only for port terminal station 
* Specify only for DCE or DTE line station 
' Specify only for PC node station 



S$POOL Storage 



-HDLC Lines 



1 Other Line 
1 Terminal/Node 
Remote Stations 



xll2 = . 



bytes 



X 264 = 264 bytes 

X 88 = 88 bytes 

X 32 = bytes 



Figure 83. Example 5: Node 3 Line/Terminal/Node Configuration Worksheet 



EDX Definitions 



Figure 84 on page 320 shows the EDX definitions for any of the three nodes in 
this example. Notice that the 3101s are not defined to EDX, so they can be used 
only as Communications Facility terminals. If you also want to use them as EDX 
terminals, use TERMINAL statements to define them. 
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*** EXAMPLE 5: NODE 1, 2, OR 3 

'1' Sj* SfS /F TN 

$EDXDEF CSECT \ f/ 

SYSTEM MAXPROG=(10,10,10,10) ,PARTS=(32,32,32,32) , X 

COMMON= ( CSXEND , CSXEND , CSXEND , CSXEND ) , X 

INITMOD=(CSXINIT) 

$SYSPRTR TERMINAL DEVICE=4973 , ADDRESS=01 ,END=YES 

• 
LCC ADDRESS=50 SUBCHANNEL 

LCC ADDRESS=51 SUBCHANNEL 1 

LCC ADDRESS=52,END=YES SUBCHANNEL 2 

END 

Figure 84. Example 5: EDX Definitions 
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o 
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Example 6: BSC Point-to-Point Connection between Series/Is 



Figure 85 shows a configuration in which two Series/ Is are connected by a BSC 
point-to-point line. The appUcation program in node 1 communicates with users at 
3101 terminals in either node. The 3101 terminals are attached to the Series/ Is by 
feature programmable communications adapter. 



,<"> 
\.^' 







Series/ 1, Node 1 












DA = 60 


$.IO06F0 


TERM2A 

1 J 

1 p „ J 

1 ^ TERM2B 


3101 


TERM 1 A 


DA = 61 






TERM IB 


3101 






♦ f 


1 -1 






APROG 


1 1 

N0DE2 














T 

1 
1 






$.IO0A10 


LINEl 


1 






Series/ 1, Node 2 


DA =29 
BSC 
DA = 29 




DA = 60 




$.IO0A10 


LINE2 


^~1 








1 

NODEl 
1 J 


3101 






TERM2A 


APROG 
-.J- J 


DA = 61 






TERM2B 


3101 










$.IO06F0 











^A 



Figure 85. Example 6: BSC Point-to-Point Connection between Series/ Is 
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Message Flow 



o 



The flow of messages between the terminals in node 1 and the application program 
is as described for example 4. The flow of messages between nodes 1 and 2 is 
similar to that described for example 4, but there are some important differences. 

Look at the station definition worksheets for example 6. As for example 4, each 
node has a unique node assignment, and there are definitions of all remote stations 
to which local stations will send messages. The differences appear in the 
line/terminal/node configuration worksheets for nodes 1 and 2. In each node, the 
remote node is defined as a node station with no ring address or line name. (If you 
prefer, you can define the remote node as a CPU line station, with the same 
network address as the other end of the line. The effect of these two definitions is 
identical when the station is started.) 

When these stations have been defined, linked as shown in the diagram of the 
configuration, and started, a display of the active stations in node 2 will show this 
information: 



STATION 


TYPE 


NA 


LINK 


$.DISP 


0000 


0200 


0000 


N0DE1 


0800 


0100 


0229 


LINE2 


0A10 


0229 


0000 


TERM2A 


06F0 


0260 


01 AC 


TERM2B 


06F0 


0261 


01AC 


APROG 


0800 


01 AC 


0000 



Notice the following: 

• The network address of $.DISP (the system station) shows that the node 
assignment is 02. This is the result of issuing a CP SET NODE command. 

• The remote program station (APROG) has a vector station block (type 08). 
This is the result of starting a station whose type is other than NODE and 
whose network address is not in this node. 

• The remote node station (NODEl) has a vector station block (type 08). This 
is the result of starting a station whose type is NODE, but which doesn't have 
an associated line station. 

A message from TERM2A is routed to the appUcation program in node 1 in almost 
the same way as in example 4. The 3101 lOCP, $.IO06F0, sends the message to 
the origin station's link, APROG, whose network address is OlAC. The message 
dispatcher determines that the address is not in this node, sets the second b5^e to 
00, and looks for a station with that network address (0100). Station NODEl 
satisfies the search, so the message dispatcher puts the message on the queue of the 
station to which NODEl is hnked. That station is the one with network address 
0229 (LINE2). 

It's this last step that is different from example 4; the difference arises because of 
the type of the station that has network address 0100. In example 4, it was a node 
station (type 10), so the message dispatcher put the message on its queue. Here it's 
a vector station (type 08), so the message dispatcher put the message on its link's 
queue. 

The method of routing messages between nodes accounts for the restriction that 
you can't have more than one active BSC point-to-point connection. Local 
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Station Definitions 



Communications Controller connection, or X.25 connection through circuit 

stations with usage CF between two Series/ Is. For all these connections, a station 

with network address nnOO is required to route messages to node nn, and you can't ^r-^ 

start more than one station with a given network address. 

Subsequently, the Series/ 1-to-Series/l point-to-point lOCP, $.IO0A10, retrieves 
the message from LINE2's queue and sends it over the BSC line to node 1. 
$.IO0A10 in node 1 reads the message and sends it to the message dispatcher. The 
message carries its original routing information showing that the origin is 0260 and 
the destination is 01 AC. The message dispatcher determines that the destination 
network address is in this node, so it puts the message on APROG's queue. The 
response from APROG to TERM2A is routed in a similar manner. 

In summary, to enable communication between nodes over a point-to-point line, 
you must: 

• Give each node a unique node assignment. 

• In each node, define the remote stations to which local stations will send 
messages. Be sure that the network address is the same as that of the 
corresponding real station in the remote node. The station names need not be 
the same. 

• In each node, define the local Une station and the remote node station. Link 
the remote node station to the local line station. 

• When you start the Communications Facility, issue a CP SET NODE 
command to set the node assignment before starting any remote stations. 






Figure 86 on page 325 through Figure 91 on page 330 show the station 
definitions for the two nodes in this configuration. 
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User /Message /Alias /Volume Configuration Worksheet 



System: Example 6: Series/ 1 -Series/ 1, Node 1 
Node Assignment: 01 



Description 


Name 


NA 


Type 


Alias' 


3101-FPCAIOCP 


$.IO06F0 


OlAA 


USER 




Series/ 1 -Series/ 1 lOCP 


S.IOOAIO 


OlAB 


USER 




Application program 


APROG 


01 AC 


USER 





Specify only for alias station 



SSPOOL Storage 



3 User/Msg Stations 

Alias Stations 

Remote Stations 

Volume Stations 



X 88 = 264 bytes 

X 40 = bytes 

X 32 = bytes 

X 104 = bytes 



Figure 86. Example 6: Node 1 User/Message/AUas/Volume Configuration Worksheet 
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Device Configuration Worksheet 



System: Example 6: Series/ 1 -Series/ 1 , Node 1 
Node Assignment: 01 



Description 


Name 


NA 


Type 


Device Type 


Buffer 
Size 


PDS' 


Polling 
CUDA 


Selection 
CUDAV 
HDCPY' 


Bit Rate' 


Auto 
Ans' 


3101 


TERM 1 A 


0160 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


4800 


Y 


3101 


TERM IB 


0161 


DEVICE 


3101F 


2500 




4040 


$SYSPRTR 


4800 


Y 


Remote 3101 


TERM2A 


0260 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


4800 


Y 


Remote 3101 


TERM2B 


0261 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


4800 


Y 



' Specify only for printer device station 
^ Specify only for printer or 4978 device station 
' Specify only for 3101 or 3 101 F device station 
" Specify only for 31 OIF device station 
For 7485s, bit rate must be 9600 and AUTO ANS=NO 



'iJ 



SSPOOL Storage 



_3 1 1 F Devices x 1 60 = bytes 

_4978/Printer Devices x 264 = bytes 



2 3101 Devices 
2 Remote Stations 



X 304 = 608 bytes 
X 32 = 64 bytes 






Figure 87. Example 6: Node 1 Device Configuration Worksheet 



^k^ 
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Line /Terminal /Node Configuration Worksheet 



System: Example 6: Series/ 1 -Series/ 1, Node 1 
Node Assignment: 01 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


BSC line 


LINEl 


0129 


LINE 


CPU 


2500 









Terminal and Node Definitions 






Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name' 


Polling 

CUDAV 

Port#* 


Select 
CUDA» 


Node 2 


NODE2 


0200 


NODE 


CF 













' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
" Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 



S$POOL Storage 



-HDLC Lines 



1 Other Line 

Terminals/ Nodes 

1 Remote Station 



xll2 = . 



bytes 



X 264 = 264 bytes 

X 88 = bytes 

X 32 = 32 bytes 



Figure 88. Example 6: Node 1 Line/Terminal/Node Configuration Worksheet 
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User / Message / Alias / Volume Configuration Worksheet 



System: Example 6: Series/ 1 -Series/ 1 Node 2 
Node Assignment: 02 






Description 


Name 


NA 


Type 


Alias' 


3101-FPCAIOCP 


$.IO06F0 


02AA 


USER 




Series/ 1-Series/l lOCP 


S.IOOAIO 


02AB 


USER 




Remote application program 


APROG 


OlAC 


USER 





Specify only for alias station 



SSPOOL Storage 



2 User/Msg Stations 

Alias Stations 

1 Remote Station 
Volume Stations 



x88= 176 bytes 

X 40 = bytes 

X 32 = 32 bytes 

X 104 = bytes 



Figure 89. Example 6: Node 2 User/Message/ Alias/Volume Configuration Worksheet 






1 J 
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c 



Device Configuration Worksheet 



System: Example 6: Series/ 1 -Series/ 1, Node 2 
Node Assignment: 02 



Description 


Name 


NA 


Type 


Device Type 


Buffer 
Size 


PDS' 


Polling 
CUDA 


Selection 
CUDAV 
HDCPY' 


Bit Rate' 


Auto 
Ans* 


3101 


TERM2A 


0260 


DEVICE 


3101F 


2500 




4040 


SSYSFRTR 


4800 


Y 


3101 


TERM2B 


0261 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


4800 


Y 



' specify only for printer device station 
^ Specify only for printer or 4978 device station 
' Specify only for 3101 or 31 OIF device station 
■* Specify only for 31 OIF device station 
For 7485s, bit rate must be 9600 and AUTO ANS=NO 



S$POOL Storage 



.3 101 F Devices 
_4978/Printer Devices 



X 160 = . 
X 264 = 



. bytes 
. bytes 



2 3101 Devices 
Remote Stations 

Figure 90. Example 6: Node 2 Device Configuration Worlulieet 



X 304 = 608 bytes 
X 32 = bytes 
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Line /Terminal /Node Configuration Worksheet 



System: Example 6: Series/ 1 -Series/ 1, Node 2 
Node Assignment: 02 






Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


BSC line 


LINE2 


0229 


LINE 


CPU 


2500 









Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address^ 


Line Name 


Volume 
Name' 


Polling 
CUDAV 

Port#' 


Select 
CUDA' 


Nodel 


NODEl 


0100 


NODE 


CF 













' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
" Specify only for port terminal station 
* Specify only for DCE or DTE line station 
' Specify only for PC node station 



S$POOL Storage 






.HDLC Lines 



X 112 = 



bytes 



1 Other Line x 264 = 264 bytes 

Terminals/Nodes x 88 = bytes 

1 Remote Station x 32 = 32 bytes 

Figure 91. Example 6: Node 2 Line/Terminal/Node Configuration Worksheet 



EDX Definitions 



Figure 92 on page 331 shows the EDX definitions for either node in this example. 
Notice that the 3101s are not defined to EDX, so they can be used only as 
Communications Facility terminals. If you also want to use them as EDX 
terminals, use TERMINAL statements to define them. 
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*** EXAMPLE 6, NODE 1 OR 2 
**^ 

$EDXDEF CSECT 

SYSTEM MAXPROG=(10,10,10,10) ,PARTS=(32,32,32,32) , X 

COMMON= ( CSXEND , CSXEND , CSXEND , CSXEND ) , X 

INITMOD= (CSXINIT) 

• 

$SYSPRTR TERMINAL DEVICE=4973 , ADDRESS=01 ,END=YES 

BSCLINE ADDRESS=29,TYPE=PT,END=YES SERIES/1 -SERIES/1 
END 

Figure 92. Example 6: EDX Definitions 
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Example 7: BSC Multipoint Connection between Series/Is 

Figure 93 on page 333 shows a configuration in whicli three Series/ Is are U 1) 

connected by a BSC multipoint line. The application program in node 1 
communicates with users in all three nodes. 

The 3270 emulation lOCP, $.IO0AE0, manages the BSC line at nodes 2 and 3. 
Each of these Series/ Is appears to be a 3270 system — a 3271 control unit with 
two 3277 display stations. The 3270 control lOCP, $.IO0AC0, manages the BSC 
line at node 1. It communicates with the two emulated 3270 systems just as if it 
were communicating with two real 3270 systems. 



Message Flow 



The routing of messages between nodes in this configuration is done according to 
the 3270 polling and selection addresses of the 3271 control and emulation 
terminal stations. Look at the line/terminal/node configuration worksheets for the 
three nodes. Notice that the poUing and selection addresses of the control 
terminals in node 1 match the polling and selection addresses of the emulation 
terminals in nodes 2 and 3. 

A message from one of the 4978s in node 2 is routed to the appUcation program in 

node 1 as follows. The message is entered at station TERM2A and sent to its link, 

station ETERM2A. Subsequently, when $.100 AEO is polled by $.100 ACO, it 

retrieves the message from ETERM2A's queue, inserts ETERM2A's polling 

address (C240), and writes the message to the BSC line. $.100 ACO receives the 

message in node 1 and disposes of it according to the poUing address. Address ^f~\. 

C240 identifies station CTERM2A, so the message is sent to its link, station [i J 

APROG. 

When APROG receives the message, it no longer has its original routing 
information. The origin station is CTERM2A, not TERM2A. When APROG 
sends a response to the message, the response is routed back over the same 
path— from CTERM2A to ETERM2A and then to its Unk, TERM2A. A separate 
path between each remote device and the application program is required because 
the original routing information is lost. If the messages flowed in only one 
direction, from node 2 to node 1 , all messages from node 2 could be routed through 
a single pair of emulation/control terminal stations. But if responses were routed 
back over the single path, there would be no way to determine which node 2 
station should receive the message. 

In this example, each node has been given a unique node assignment. This is not 
required in this case, because there are no remote stations (that is, there is no 
station whose network address identifies it as being in a remote node). You can 
issue CP SET NODE commands to set node assignments, but you don't have to. If 
you don't, the node assignment is 00, and the message dispatcher treats all stations 
as local stations, whatever their network address. 



£~^ 
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4978 



4978 



Series/ 1, Node 1 



$.100670 



DA = 04 



TERMIA 



DA= 14 



TERM IB 



\ —7 

\ / 

\ / 



/ 



APROG 
19 ^ 



\ 



/ 



\ 



CTERM2A 



u^ 



CTERM2B 



CCU2 



$.100 AGO 



.I:^ 



GTERM3A 



CGU3 



GLINE 



GTERM3B 



' DA = 19 



Series/ 1, Node 2 



/ DA = 09 



$.IO0AE0 



Series/ 1, Node 3 



\ DA = 09 



ELINE 



EGU2 



ETERM2A 



ETERM2B 



$.100670 



TERM2A 



TERM2B 



DA = 04 



4978 



ELINE 



EGU3 



ETERM3A 



$.IO0AE0 



ETERM3B 



TERM3A 



DA = 14 



4978 



TERM3B 



DA = 04 



4978 



$.100670 



DA= 14 



4978 



Figure 93. Example 7: BSC Multipoint Connection between Series/Is 



%J 
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In summary, what you must do to enable communication between nodes over a 
BSC multipoint line is: 

• Designate one of the nodes as the control node and the other nodes as 
tributary (emulation) nodes. 

• In each tributary node, define: 

- One emulated 3271 station. 

- One emulated 3277 station for each station that will send messages to a 
station in the control node, 

• In the control node, define: 

- One control 3271 station for each tributary node, with the same polling 
address as the emulated 3271 station. 

- The same number of control 3277 stations as emulated 3277 stations, with 
matching poUing and selection addresses. 



Station Definitions 



Figure 94 through Figure 102 on page 340 show the station definitions for this 
example. 



User /Message /Alias /Volume Configuration Worksheet 



System: Example 7: 3270 Emulation/Control, Node 1 
Node Assignment: 01 



/If 



W 



Description 


Name 


NA 


Type 


Alias' 


4978 lOCP 


$.100670 


OlAA 


USER 




3270 control lOCP 


S.IOOACO 


OlAB 


USER 




Application program 


APROG 


OlAC . 


USER 





Specify only for alias station 



S$POOL Storage 



3 User/Msg Stations 

Alias Stations 

Remote Stations 

Volume Stations 



X 88 = 264 bytes 

X 40 = bytes 

X 32 = bytes 

X 104 = bytes 



Figure 94. Example 7: Node 1 User/Message/ Alias/ Volume Configuration Worksheet 



\J 
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Device Configuration Worksheet 



System: Example 7: 3270 Emulation /Control, Node 1 
Node Assignment: 01 



Description 


Name 


NA 


Type 


Device Type 


Buffer 
Size 


PDS» 


Polling 
CUDA 


Selection 
CUDAV 
HDCPY' 


Bit Rate' 


Auto 
Ans' 


4978 


TERM 1 A 


0104 


DEVICE 


4978 


2500 




4040 


0000 






4978 


TERM IB 


0114 


DEVICE 


4978 


2500 




4040 


0000 







' specify only for printer device station 
^ Specify only for printer or 4978 device station 
^ Specify only for 3101 or 3 101 F device station 
" Specify only for 3 101 F device station 
For 7485s, bit rate must be 9600 and AUTO ANS=NO 



SSPOOL Storage 



.31 OIF Devices 



2 4978/Printer Devices 

3101 Devices 

Remote Stations 



xl60 = 



bytes 



x264 = 528 bytes 

X 304 = bytes 

X 32 = bytes 



Figure 95. Example 7: Node 1 Device Configuration Worksheet 



1l J 
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Line / Terminal / Node Configuration Worksheet 



System: Example 7: 3270 Emulation/Control, Node 1 
Node Assignment: 01 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size* 


Window' 


BSC line 


CLINE 


0119 


LINE 


3271C 


2500 









Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name' 


Polling 

CUDAV 

Portr 


Select 
CUDA' 


Control unit 


CCU2 


OlCl 


TERM 


3271 




CLINE 




C27F 


0000 


Terminal 


CTERM2A 


01C2 


TERM 


3277 




CLINE 




C240 


E240 


Terminal 


CTERM2B 


01C3 


TERM 


3277 




CLINE 




C2C1 


E2C1 


Control unit 


CCU3 


01 C4 


TERM 


3271 




CLINE 




C37F 


0000 


Terminal 


CTERM3A 


01C5 


TERM 


3277 




CLINE 




C340 


E340 


Terminal 


CTERM3B 


01C6 


TERM 


3277 




CLINE 




C3C1 


E3C1 



' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
^ Specify only for 3271, 3277, or 3286 terminal station 
" Specify only for port terminal station 
^ Specify only for DCE or DTE line station 
' Specify only for PC node station 






S$POOL Storage 



.HDLC Lines 



X 112 



bytes 



1 Other Line 

6 Terminals/Nodes 

Remote Stations 



X 264 = 264 bytes 
X 88 = 528 bytes 
X 32 = bytes 



Figure 96. Example 7: Node 1 Line/Terminal/Node Conf^;uration Worksheet 



o 
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User /Message /Alias /Volume Configuration Worksheet 



System: Example 7: 3270 Emulation/Control, Node 2 
Node Assignment: 02 



Description 


Name 


NA 


Type 


Alias' 


4978 lOCP 


$.100670 


02AA 


USER 




3270 emulation lOCP 


S.IOOAEO 


02AB 


USER 





' Specify only for alias station 



SSPOOL Storage 



2 User/Msg Stations 

Alias Stations 

Remote Stations 



.Volume Stations 



x88 = 176 bytes 

X 40 = bytes 

X 32 = bytes 

X 104 = bytes 



Figure 97. Example 7: Node 2 User/Message/ Alias/ Volume Configuration Worksheet 



Device Configuration Worksheet 



System: Example 7: 3270 Emulation/Control, Node 2 
ik^ Node Assignment: 02 



Description 


Name 


NA 


Type 


Device Type 


Buffer 

Size 


PDS' 


Polling 
CUDA 


Selection 
CUDAV 
HDCPY' 


Bit Rate' 


Auto 
Ans' 


4978 


TERM2A 


0204 


DEVICE 


4978 


2500 




4040 


0000 






4978 


TERM2B 


0214 


DEVICE 


4978 


2500 




4040 


0000 







' Specify only for printer device station 
^ Specify only for printer or 4978 device station 
' Specify only for 3101 or 3 101 F device station 
* Specify only for 3 101 F device station 
For 7485s, bit rate must be 9600 and AUTO ANS=NO 



SSPOOL Storage 



.31 OIF Devices 



X 160 = 



bytes 



2 4978/Printer Devices 

3101 Devices 

Remote Stations 



X 264 = 528 bytes 

X 304 = bytes 

X 32 = bytes 



Figure 98. Example 7: Node 2 Device Conf juration Worksheet 
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Line/Terminal/Node Configuration Worksheet 



System: Example 7: 3270 Emulation/Control, Node 2 
Node Assignment: 02 






Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


BSC tributary line 


ELINE 


0209 


LINE 


327 IE 


2500 









Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name' 


Polling 

CUDAV 

Portr 


Select 
CUDA' 


Control unit 


ECU2 


02E1 


TERM 


3271 




ELINE 




C27F 


0000 


Terminal 


ETERM2A 


02E2 


TERM 


3277 




ELINE 




C240 


E240 


Terminal 


ETERM2B 


02E3 


TERM 


3277 




ELINE 




C2C1 


E2C1 



' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
'' Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 






S$POOL Storage 



-HDLC Lines 



1 Other Line 

3 Terminals/Nodes 

Remote Stations 



X112 



bytes 



X 264 = 264 bytes 
X 88 = 264 bytes 
X 32 = bytes 



F^ure 99. Example 7: Node 2 Line/Terminal/Node Configuration Worksheet 



338 Communications Facility Design and Installation Guide 



o 



User /Message /Alias /Volume Configuration Worksheet 



System: Example 7: 3270 Emulation/Control, Node 3 
Node Assignment: 03 



Description 


Name 


NA 


Type 


Alias' 


4978 lOCP 


$.100670 


03AA 


USER 




3270 emulation lOCP 


S.IOOAEO 


03AB 


USER 





' Specify only for alias station 



S$POOL Storage 



2 User/Msg Stations 

Alias Stations 

Remote Stations 



-Volume Stations 



X 88 = 176 bytes 

X 40 = bytes 

X 32 = bytes 

X 104 = bytes 



Figure 100. Example 7: Node 3 User /Message/Alias/ Volume Configuration Worksheet 



\pr 



Device Configuration Worksheet 



System: Example 7: 3270 Emulation/Control, Node 3 
Node Assignment: 03 



Description 


Name 


NA 


Type 


Device Type 


Buffer 
Size 


PDS' 


Polling 
CUDA 


Selection 
CUDAV 
HDCPY* 


Bit Rate' 


Auto 
Ans' 


4978 


TERM3A 


0304 


DEVICE 


4978 


2500 




4040 


0000 






4978 


TERM3B 


0314 


DEVICE 


4978 


2500 




4040 


0000 







' Specify only for printer device station 
^ Specify only for printer or 4978 device station 
' Specify only for 3101 or 31 OIF device station 
" Specify only for 3 101 F device station 
For 7485s, bit rate must be 9600 and AUTO ANS=NO 



SSPOOL Storage 



-31 OIF Devices 



X 160 



bytes 



2 4978/Printer Devices 

3101 Devices 

Remote Stations 



X 264 = 528 bytes 

X 304 = bytes 

X 32 = bytes 



Figure 101. Example 7: Node 3 Device Configuration Worksheet 
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Line / Terminal / Node Configuration Worksheet 



System: Example 7: 3270 Emulation/Control, Node 3 
Node Assignment: 03 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


BSC tributary line 


ELINE 


0309 


LINE 


327 IE 


2500 









Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name* 


Polling 

CUDAV 

Portr 


Select 
CUDA' 


Control unit 


ECU3 


03E1 


TERM 


3271 




ELINE 




C37F 


0000 


Terminal 


ETERM3A 


03E2 


TERM 


3277 




ELINE 




C340 


E340 


Terminal 


ETERM3B 


03E3 


TERM 


3277 




ELINE 




C3C1 


E3C1 



' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
" Specify only for port terminal station 
' Specify only for DCE or DTE line station 
^ Specify only for PC node station 



o 



SSPOOL Storage 



.HDLC Lines 



1 Other Line 

3 Terminals/Nodes 

Remote Stations 



xll2 = 



bytes 



X 264 = 264 bytes 
X 88 = 264 bytes 
X 32 = bytes 



Figure 102. Example 7: Node 3 Line/Terminal/Node Configuration Worksheet 



o 
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EDX Definitions 

Figure 103 shows the EDX definitions for the control node. 



*** EXAMPLE 7, NODE 1 

$EDXDEF CSECT 

SYSTEM MAXPROG=(10,10,10,10) ,PARTS=(32,32,32,32) , X 

COMMON= ( CSXEND , CSXEND , CSXEND , CSXEND) , X 

INITMOD= (CSXINIT) 

• 
TERM1 TERMINAL DEVICE=4978 , ADDRESS=04,HDCOPY=$SYSPRTR 
TERM2 TERMINAL DEVICE=4978 , ADDRESS=14,HDC0PY=$SYSPRTR 
$SYSPRTR TERMINAL DEVICE=4973 , ADDRESS=0 1 , END=YES 

• 

BSCLINE ADDRESS=19,TYPE=MC,END=YES 3271 CONTROL 
END 

Figure 103. Example 7: Node 1 EDX Definitions 



Figure 104 shows the EDX definitions for either of the tributary nodes. 



*** EXAMPLE 7, NODE 2 OR 3 

$EDXDEF CSECT 

SYSTEM MAXPROG=(10,10) ,PARTS=(32,32) , X 

COMMON= ( CSXEND , CSXEND ) , X 

INITMOD= (CSXINIT) 
• 
• 
TERM1 TERMINAL DEVICE=4978 , ADDRESS=04 , HDCOPY=$SYSPRTR 
TERM2 TERMINAL DEVICE=4978, ADDRESS=14, HDCOPY=$SYSPRTR 
$SYSPRTR TERMINAL DEVICE=4973 , ADDRESS=01 ,END=YES 
• 

BSCLINE ADDRESS=09,TYPE=MT,END=YES 3271 EMULATION 
END 



Figure 104. Example 7: Node 2 or 3 EDX Definitions 
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Example 8: BSC Multipoint Connection with Transaction Processing 

Figure 105 on page 343 shows a configuration in which three Series/ Is and a host H Li 

computer are connected by BSC multipoint Unes. This example includes the ^K^ 

program dispatcher with support for remote disk, remote IPL, and remote 

management functions. Node 1 is considered the central site. It has the disks and 

the definitions that allow it to do remote management of nodes 2 and 3 and IPL 

them. Nodes 2 and 3 have definitions that allow them to access volumes EDX003 

and USRVOL on node I's disks. 

The example doesn't include Communications Facility terminals; you could, of 
course, add them to such a configuration. 



Message Flow 



The routing of messages between node 1 and the host is as explained in example 1 , 
The routing of messages between nodes is as explained in example 7. Be sure you 
understand the requirements, given in example 7, for communication between 
nodes over a BSC multipoint Une. 

Look at Figure 106 on page 344, the program dispatcher data sets. The path 
stations are the control and emulation terminal stations by which messages are 
routed from one node to another. A link from each path station to the program 
dispatcher is required, but you don't have to define them. The program dispatcher 
sets the links when it's started. 
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Host 
Cell HT 



Series/ 1 

Node 1, Cell CI 



Disks 



EDX002 



EDX003 



ASMLIB 



DA = 03 



USRVOL 



DA = 48 



$.IO0AE0 



DA = 09 



HOST 



ECUl 



ETERMl 



$.PD 


;• 


•( 



1. 



CTERM2 



CCU2 



$.IO0AC0 



_L 



CTERM3 



ecu 3 



CLINE 



Series/ 1 

Node 2, Cell C2 



DA = 09 



DA= 19 



h 



$.IO0AE0 



ELINE 



ECU2 



ETERM2 
\ 



$.PD 



DA = 09 Series/1 

Node 3, Cell C3 





ELINE 


$IO0AE0 




ECU 3 






ETERM3 






I 
1 

1 




$.PD 











Figure 105. Example 8: BSC Multipoint Connection with Transaction Processing 
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*** EXAMPLE 8^ CELL C1 ^^ 

SET LOG $SYSPRTR ' f] 

S HOST ECU1 \^,j' 

S CLINE CCU2 CCU3 

/* 

CELL CI 

PATH ETERM1 ,HT,C P 

PATH CTERM2,C2 

PATH CTERM3,C3 

/* 

TID <I0> $.PD<IO>,,,N 32 

TID IPL $.PDIPL 22 

TID HMU $.HMU 22 

/* 

SYST** MS********CELL CI IS OPERATIONAL 

/* 

*** EXAMPLE 8, CELL C2 
SET LOG $SYSPRTR 
S ELINE ECU2 

/* 

CELL C2 

PATH ETERM2,C1 P 

/* 

TID RMU $.RMU 22 

/* 

SYST SPE1C1 

SYST** MS********CELL C2 IS OPERATIONAL 

SYSTC1 CP PD T C2 

/* 

*** EXAMPLE 8, CELL C3 ^'^ 

SET LOG $SYSPRTR L J 

S ELINE ECU3 ^--^ 

/* 

CELL C3 

PATH ETERM3,C1 P 

/* 

TID RMU $.RMU 22 

/* 

SYST SPE1C1 

SYST** MS********CELL C3 IS OPERATIONAL 

SYSTC1 CP PD T C3 

/* 

Fi^:iire 106. Example 8: Program Dispatcher Data Sets 



Let's see What happens to a transaction with primary cell identifier CI that 
originates in cell C2: 

1. The program dispatcher in cell C2 receives the transaction, determines that the 
path to ceU CI is station ETERM2, and sends the transaction to that station. 

2. Subsequently, $.IO0AE0 retrieves the transaction from ETERM2's queue, 
inserts ETERM2's polling address (C240), and sends the transaction over the 
BSC Une. 



3. $.100 ACO in cell CI reads the data and disposes of it according to the polling 
address. Address C240 identifies station CTERM2, so the transaction is sent 
to its link, $.PD. 






344 Communications Facility Design and Installation Guide 



The program dispatcher retrieves the transaction from its queue, determines 
that it is to be processed in this cell, and routes it according to the primary 
transaction identifier. 



Program Dispatcher Data Sets 






Figure 106 on page 344 shows the program dispatcher data set ($.SYSPD) for 
each of the three cells. The commands in the first part of each data set assign 
$SYSPRTR as the Communications Facility log and start the line stations and the 
3271 terminal stations. You don't have to start the path stations; the program 
dispatcher does that when it's started. You can add commands to start other 
stations in your configuration, or you can start them independently of the program 
dispatcher. 

The second part of each data set defines the local cell and the paths to remote cells. 
In cell CI, the path to the host system is the preferred path. The definition 
specifies data conversion, so binary data can be transmitted to and from the host. 
In cells C2 and C3, only the path to CI is defined, but it provides a path to all cells 
because it is the preferred path. You could define paths to each of the other cells 
(they could all use the same path station), but the effect would be the same. 

The third part of cell Cl's data set defines the transactions that support remote 
disk, remote IPL, and the host management utility program. The third part of cell 
C2's and C3's data set defines the transaction for the remote management utility 
program. 

The SYST MS broadcast transaction in the fourth part of cell Cl's data set notifies 
all cells that CI is operational. The message goes to all EDX terminals in all cells. 
The transaction also goes to the host system. If this causes a problem with the host 
transaction-processing program, route a SYST MS transaction to each of the 
Series/ 1 cells instead of using a broadcast transaction. 

The SYST SP transaction in C2's and C3's data set causes remote disk support 
(CSPDIO) in those cells to release control of the BSC line so that $.100 AEO can 
use it. The SYST CP transactions cause cell CI to send its system time and date to 
cells C2 and C3. 



IPL Transaction Data Set 



Station Definitions 



An IPL transaction data set ($.SYSLCC) is required in cell CI, because there is a 
definition of transaction IPL. The data set won't be used (it's used only for Local 
Communications Controller hardware IPL requests), so it can be a small empty 
data set. 



Figure 107 on page 346 through Figure 112 on page 351 show the station 
definitions for the three nodes in this configuration. 



Sample Configurations 345 



User / Message / Alias / Volume Configuration Worksheet 



System: Example 8: BSC Multipoint with Transaction Processing, Node 1 
Node Assignment: 01 






Description 


Name 


NA 


Type 


Alias' 


3270 emulation lOCP 


S.IOOAEO 


OlAA 


USER 




3270 control lOCP 


S.IOOACO 


OlAB 


USER 




Program dispatcher 


$.PD 


OlAC 


USER 





' Specify only for alias station 



SSFOOL Storage 



3 User/Msg Stations 

Alias Stations 

Remote Stations 



-Volume Stations 



X 88 = 264 bytes 

X 40 = bytes 

X 32 = bytes 

X 104 = bytes 



F^ure 107. Example 8: Node 1 User/Message/ Alias/ Volume Configuration Worksheet 






o 
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^***v. 



o 



Line I Terminal I Node Configuration Worksheet 



System: Example 8: BSC Multipoint with Transaction Processing, Node 1 
Node Assignment: 01 

Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


BSC tributary line 


HOST 


0109 


LINE 


327 IE 


2500 








BSC control line 


CLINE 


0119 


LINE 


3271C 


2500 









Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name' 


Polling 

CUDAV 

Portr 


Select 
CUDA' 


Control unit 


ECUl 


OlEl 


TERM 


3271 




HOST 




407 F 


0000 


Terminal 


ETERMl 


01E2 


TERM 


3277 




HOST 




4040 


6040 


Control unit 


CCU2 


OlCl 


TERM 


3271 




CLINE 




C27F 


0000 


Terminal 


CTERM2 


01C2 


TERM 


3277 




CLINE 




C240 


E240 


Control unit 


ecus 


01C3 


TERM 


3271 




CLINE 




C37F 


0000 


Terminal 


CTERM3 


01C4 


TERM 


3277 




CLINE 




C340 


E340 



' specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
■* Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 



S$POOL Storage 



.HDLC Lines 



X 112 



bytes 



2 Other Lines 

6 Terminals/Nodes 

Remote Stations 



X 264 = 528 bytes 
X 88 = 528 bytes 
X 32 = bytes 



Figure 108. Example 8: Node 1 Line/Terminal/Node Configuration Worksheet 
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User /Message /Alias /Volume Configuration Worksheet 



System: Example 8: BSC Multipoint with Transaction Processing, Node 2 
Node Assignment: 02 






Description 


Name 


NA 


Type 


Alias* 


3270 emulation lOCP 


S.IOOAEO 


02AA 


USER 




Program dispatcher 


$.PD 


02AB 


USER 





Specify only for alias station 



SSPOOL Storage 



2 User/Msg Stations 

Alias Stations 

Remote Stations 

Volume Stations 



x88 = 176 bytes 

X 40 = bytes 

X 32 = bytes 

X 104 = bytes 



Figure 109. Example 8: Node 2 User/Message/ Alias/Volume Conflguration Worksheet 



,4"'"^' 
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Line / Terminal / Node Configuration Worksheet 



System: Example 8: BSC Multipoint with Transaction Processing, Node 2 
Node Assignment: 02 









Line Definitions 










Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


BSC tributary line 


ELINE 


0209 


LINE 


327 IE 


2500 









Terminal and Node Definitions 



^"*\ 
\t^ 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name' 


Polling 

CUDAV 

Portr 


Select 
CUDA' 


Control unit 


ECU2 


02E1 


TERM 


3271 




ELINE 




C27F 


0000 


Terminal 


ETERM2 


02E2 


TERM 


3277 




ELINE 




C240 


E240 



' specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
" Specify only for port terminal station 
^ Specify only for DCE or DTE line station 
' Specify only for PC node station 



SSPOOL Storage 



.HDLC Lines 



1 Other Line 

2 Terminals/Nodes 
Remote Stations 



xll2 = . 



bytes 



X 264 = 264 bytes 
x88 = 176 bytes 
X 32 = bytes 



Figure 110. Example 8: Node 2 Line/Terminal/Node Configuration Worksheet 



o 
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User /Message /Alias I Volume Configuration Worksheet 



f(^\, 



System: Example 8: BSC Multipoint with Transaction Processing, Node 3 
Node Assignment: 03 



Description 


Name 


NA 


Type 


Alias' 


3270 emulation lOCP 


S.IOOAEO 


03AA 


USER 




Program dispatcher 


$.PD 


03AB 


USER 





Specify only for alias station 



S$POOL Storage 



2 User/Msg Stations 

Alias Stations 

Remote Stations 

Volume Stations 



x88 = 176 bytes 

X 40 = bytes 

X 32 = bytes 

X 104 = bytes 



Figure 111. Example 8: Node 3 User/Message/ Alias/ Volume Configuration Worksheet 






^luJ' 
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Line /Terminal /Node Configuration Worksheet 



System: Example 8: BSC Multipoint with Transaction Processing, Node 3 
Node Assignment: 03 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


BSC tributary line 


ELINE 


0309 


LINE 


327 IE 


2500 









Terminal and Node Definitions 






Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name* 


Polling 

CUDAV 

Port#* 


Select 
CUDA' 


Control unit 


ECU3 


03E1 


TERM 


3271 




ELINE 




C37F 


0000 


Terminal 


ETERM3 


03E2 


TERM 


3277 




ELINE 




C340 


E340 



' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 

* Specify only for port terminal station 

' Specify only for DCE or DTE line station 

* Specify only for PC node station 



S$POOL Storage 



-HDLC Lines 



xll2 = 



bytes 



1 Other Line 

2 Terminals/Nodes 
Remote Stations 



X 264 = 264 bytes 
X 88 = 176 bytes 
X 32 = bytes 



Figure 112. Example 8: Node 3 Line/Terminal/Node ConHlguration Worksheet 



EDX Definitions 



Figure 113 on page 352 shows the EDX definitions for node 1. 
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*** EXAMPLE 8, NODE 1 
*** 

$EDXDEF CSECT 

SYSTEM MAXPROG= ( 1 , 1 , 10,10) ,PARTS= (32 , 32 , 32 , 32) , 
COMMON= (CSXEND , CSXEND , CSXEND , CSXEND) , 
INITMOD= (CSXINIT) 






DISK DEVICE=4962-3,ADDRESS=03, 

VOLNAME= (EDX002 , EDX003 , ASMLIB) , TASK=YES 

DISK DEVICE=4963-29,ADDRESS=48, 

VOLNAME= (USRVOL) , TASK=YES , END=YES 



BSCLINE 
BSCLINE 
END 



ADDRESS=09,TYPE=MT,END=YES 3271 EMULATION 
ADDRESS=19,TYPE=MC,END=YES 3271 CONTROL 



Figure 113. Example 8: Node 1 EDX Definitions 



Figure 114 shows the EDX definitions for either node 2 or node 3. 



*** EXAMPLE 8, NODE 2 OR 3 
$EDXDEF 



CSECT 

SYSTEM MAXPROG= ( 1 , 1 , 10,10) , PARTS= (32 , 32 , 32 , 32) , 

COMMON= ( CSXEND , CSXEND , CSXEND , CSXEND ) , 

INITMOD= (CSXINIT) 



'\^J 



DISK DEVICE=4962-3,ADDRESS=E1 , 
VOLNAME=(EDX003) ,TASK=NO 

DISK DEVICE=4963-29,ADDRESS=E2, 

VOLNAME= ( REMVOL ) , TASK=NO , END=YES 



CDRVTA TERMINAL DEVICE=VIRT, ADDRESS=CDRVTB,LINSIZE=254 ,SYNC=YES 
CDRVTB TERMINAL DEVICE=VIRT, ADDRESS=CDRVTA,LINSIZE=254,END=YES 



BSCLINE 

DEFINE 

DEFINE 

DEFINE 

END 



ADDRESS=09,TYPE=MT,END=YES 3271 EMULATION 

DEVICE , CUDA=X ' C240 ' , LINE=9 , CELL=C2 , ADDRESS= (El , E2 ) 15 

VOLUME , CELL=C1 , VOLNAME= (EDX003 ,EDX003 ) 

VOLUME , CELL=C 1 , VOLNAME= ( REMVOL , USRVOL ) , END=YES 



Figure 114. Example 8: Node 2 or 3 EDX Definitions 



Notice the definitions for remote disks and for the virtual terminals required by the 
remote management utihty program. 



o 



15 CELL=C3 for node 3 and CUDA=X'C340' for cell C3. 
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Sample Configurations 353 



Example 9: Local Communications Controller Connection with 
Transaction Processing 



Message Flow 



Figure 1 15 on page 355 shows a configuration in whicli three Series/ Is are 
connected to a Local Communications Controller. This example includes the 
program dispatcher with support for remote disks, remote IPL, and remote 
management functions. Node 1 is considered the central site. It has the disks and 
the definitions that allow it to do remote management of nodes 2 and 3 and IPL 
them. Nodes 2 and 3 have definitions that allow them to access volumes EDX002 
and EDX003 on node I's disk. 

The example doesn't include Communications FaciUty terminals or communication 
with a host system; you could, of course, add them to such a configuration. 



The routing of messages between nodes on a Local Communications Controller is 
as explained in example 4. Be sure you understand that example before you study 
this one. 

Look at Figure 1 16 on page 356, the program dispatcher data sets. The path 
stations are those that represent the remote program dispatchers. The path and 
station definitions allow transactions to be routed directly between any two cells. 
Although cell CI is considered the central site, transactions can be routed between 
cells C2 and C3 without going through CI. 









\J 
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DA = 


= 03 


Series/ 1 
Node 1, Cell CI 






















r- -1 r- — 

• PD2 1 1 PD3 


— -1 

- -1 


I{DX002 
EDX003 
ASMLIB 


Lii____JI u.__ 




$.PD 






















N0DE2 


N0DE3 














$.IO0AB0 


LCCDEV 




















DA = 50 

Ring Address = 


2F 



Series/ 1 

Node 2, Cell C2 



Ring Address = 4F 



DA = 50 




Ring Address = IF 



Series/ 1 





$.IO0AB0 


LCCDEV 










NODEl 


N0DE3 
















$.PD 




r 
1- 


PDl 


"" 


-1 P 

1 1 

J L. 


" "■ 


PD3 


• 1 
. J 







\ DA = 50 






Node 3, Cell C3 


1— 
1 

L. 




LCCDEV 


$.IO0AB0 




NODEl 


N0DE2 
















$.PD 




PE 


)1 


-1 r 

1 1 

J L 


- 


PD2 


—I 
1 



Figure 115. Example 9: Local Communications ControUer Connection with Transaction Processing 
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*** EXAMPLE 9, CELL CI 
SET LOG $SYSPRTR /^ 

SET NODE 0100 V 

S LCCDEV N0DE2 N0DE3 

/* 

CELL CI 
PATH PD2,C2 
PATH PD3,C3 

/* 

TID <I0> $.PD<I0>,,,N 32 

TID IPL $.PDIPL 22 

TID HMU $.HMU 22 

/* 

SYST** MS********CELL CI IS OPERATIONAL 

/* 



*** EXAMPLE 


9, 


CELL 


C2 




SET LOG 


$SYSPRTR 






SET NODE 


0200 








S LCCDEV 
/* 


N0DE1 


N0DE3 






CELL C2 












PATH PD1 


,C1 


P 








PATH PD3 


,C3 










/* 












TID RMU 


$.RMU 


22 






/* 












SYST 




SPE1C1 






SYST** 




MS 


********CELL 


C2 IS OPERATIONAL 


SYSTC1 




CP 


PD T 


C2 




/* 












*** EXAMPLE 


9, 


CELL 


C3 




SET LOG 


$SYSPRTR 






SET NODE 


0300 








S LCCDEV 


N0DE1 


N0DE2 


1 




/* 












CELL C3 












PATH PD1 


,C1 


P 








PATH PD2 


,C2 










/* 












TID RMU 


$.RMU 


22 






/* 












SYST 




SPE1C1 






SYST** 




MS 


****** **CELL 


C3 IS OPERATIONAL 


SYSTC1 




CP 


PD T 


C3 




/* 













V 



._# 



Figure 116. Example 9: Program Dispatcher Data Sets 



A transaction with primary cell identifier C3 that originates in cell C2 is routed as 
follows: 

1. The program dispatcher in cell C2 receives the transaction, determines that the 
path to cell C3 is station PD3, and sends the transaction to that station. 

2. PD3 is a remote station (its network address, 03 AB, is not in this node), so 
node 2's message dispatcher puts the transaction on the queue of station 
NODE3 — the station whose network address is 0300. 



o 
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3. Subsequently, $.100 ABO retrieves the message from NODE3's queue and 
sends it over the Local Communications Controller ring. 

4. Station NODES has ring address IF, so $.IO0AB0 in node 3 receives the data. 
The lOCP sends the message with its header to the message dispatcher. 

5. The header shows that the destination network address (03 AB) is in the local 
node, so the message dispatcher puts the message on the queue of the station 
with that network address, $.PD. 

6. The program dispatcher retrieves the transaction from its queue, delemiines 
that it is to be processed in this cell, and routes it according to the primary 
transaction identifier. 

Program Dispatcher Data Sets 

Figure 116 on page 356 shows the program dispatcher data set ($.SYSPD) for 
each of the three cells. The commands in the first part of each data set assign 
$SYSPRTR as the Communications Facility log, set the node assignment, and start 
the Une and node stations. You don't have to start the path stations; the program 
dispatcher does that when it's started. If you put the SET NODE command in 
$.SYSPD as shown here, be sure that you start the program dispatcher before 
starting any remote stations in your configuration. 

The second part of each data set defines the local cell and the paths to each of the 
remote cells. The remainder of each data set is the same as in example 8. See that 
example for an explanation of the TID statements and transactions. 

\ 

IPL Transaction Data Set 

An IPL transaction data set ($.SYSLCC) is required in cell CI, because that 
contains the definition of transaction IPL. The following IPL transaction data set 
enables cell CI to respond to hardware IPL requests from the other two Series/ Is: 

N0DE2 IPL CI C2B9EDX002$EDXNUC2,EDX002 
NODES IPL CI C3B9EDX002$EDXNUC3,EDX002 

The program dispatcher in cell CI responds to a hardware IPL request by sending a 
bootstrap and then a nucleus to the remote Series/ 1. If you don't intend to use 
hardware IPL requests, $.SYSLCC can be a small empty data set. 



Station Definitions 



Figure 117 on page 358 through Figure 122 on page 363 show the station 
definitions for this example. 



o 
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User I Message /Alias I Volume Configuration Worksheet 



System: Example 9: Local Communications Controller with Transactions, Node 1 
Node Assignment: 01 



' Specify only for alias station 



S$POOL Storage 



//^"^X 



Description 


Name 


NA 


Type 


Alias' 


Local Communications Controller lOCP 


S.IOOABO 


OlAA 


USER 




Program dispatcher 


$.PD 


OlAB 


USER 




Program dispatcher in node 2 


PD2 


02AB 


USER 




Program dispatcher in node 3 


PD3 


03AB 


USER 





2 User/Msg Stations 

Alias Stations 

2 Remote Stations 
Volume Stations 



x88 = 176 bytes 

X 40 = bytes 

X 32 = 64 bytes 

X 104 = bytes 



Figure 117. Example 9: Node 1 User/Message/ Alias/ Volume Configuration Worksheet 
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Line I Terminal I Node Configuration Worksheet 



System: Example 9: Local Communications Controller with Transactions, Node 1 
Node Assignment: 01 

Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address* 


Packet Size' 


Window' 


Local Communications 
Controller 


LCCDEV 


OICO 


LINE 


LCC 


2500 


50 







Terminal and Node Definitions 






Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address* 


Line Name 


Volume 
Name* 


PoUing 

CUDAV 

Portr 


Select 
CUDA' 


Node 2 


N0DE2 


0200 


NODE 


CF 


4F 


LCCDEV 








Node 3 


N0DE3 


0300 


NODE 


CF 


IF 


LCCDEV 









' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
■• Specify only for port terminal station 
* Specify only for DCE or DTE line station 
' Specify only for PC node station 






SSPOOL Storage 



-HDLC Lines 



xll2 = . 



. bytes 



1 Other Line 

2 Terminals/Nodes 
Remote Stations 



X 264 = 264 bytes 
X 88 = 176 bytes 
X 32 = bytes 



Figure 118. Example 9: Node 1 Line/Terminal/Node Configuration Worksheet 
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User /Message I Alias I Volume Configuration Worksheet 



System: Example 9: Local Communications Controller with Transactions, Node 2 
Node Assignment: 02 



o 



Description 


Name 


NA 


Type 


Alias' 


Local Communications Controller lOCP 


S.IOOABO 


02AA 


USER 




Program dispatcher 


$.PD 


02AB 


USER 




Program dispatcher in node 1 


PDl 


OlAB 


USER 




Program dispatcher in node 3 


PD3 


03AB 


USER 





' Specify only for alias station 



S$POOL Storage 



2 User/Msg Stations 

Alias Stations 

2 Remote Stations 
Volume Stations 



x88= 176 bytes 

X 40 = bytes 

X 32 = 64 bytes 

X 104 = bytes 



Figure 119. Example 9: Node 2 User/Message/Alias/Volume Configuration Worksheet 






\J 
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Line /Terminal I Node Configuration Worksheet 



System: Example 9: Local Communications Controller with Transactions, Node 2 
Node Assignment: 02 

Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


Local Communications 
Controller 


LCCDEV 


02C0 


LINE 


LCC 


2500 


50 







Terminal and Node Definitions 






Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name* 


PoUing 

CUDAV 

Portr 


Select 
CUDA' 


Nodel 


NODEl 


0100 


NODE 


CF 


2F 


LCCDEV 








Nodes 


NODE3 


0300 


NODE 


CF 


IF 


LCCDEV 









' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
* Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 



S$POOL Storage 



.HDLC Lines 



1 Other Line 

2 Terminals/Nodes 
Remote Stations 



X112 



. bytes 



X 264 = 264 bytes 
X 88 = 176 bytes 
X 32 = bytes 



%J 



Figure 120. Example 9: Node 2 Line/Terminal/Node Configuration Worksheet 
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User /Message /Alias I Volume Configuration Worksheet 



System: Example 9: Local Communications Controller with Transactions, Node 3 
Node Assignment: 03 



Description 


Name 


NA 


Type 


Alias' 


Local Communications Controller lOCP 


S.IOOABO 


03AA 


USER 




Program dispatcher 


$.PD 


03AB 


USER 




Program dispatcher in node 1 


PDl 


OlAB 


USER 




Program dispatcher in node 2 


PD2 


02AB 


USER 





Specify only for alias station 



S$POOL Storage 



2 User/Msg Stations 

Alias Stations 

2 Remote Stations 
Volume Stations 



x88 = 176 bytes 

X 40 = bytes 

X 32 = 64 bytes 

X 104 = bytes 



F^:ure 121. Example 9: Node 3 User/Message/ Alias/ Volume Configuration Worksheet 



4 \_ 
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Line I Terminal I Node Configuration Worksheet 



System: Example 9: Local Communications Controller with Transactions, Node 3 
Node Assignment: 03 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size* 


Window* 


Local Communications 
Controller 


LCCDEV 


03C0 


LINE 


LCC 


2500 


50 







Terminal and Node Definitions 






Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name* 


Polling 

CUDAV 

Portr 


Select 
CUDA' 


Nodel 


NODEl 


0100 


NODE 


CF 


2F 


LCCDEV 








Node 2 


NODE2 


0200 


NODE 


CF 


4F 


LCCDEV 









' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
* Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 



SSPGOL Storage 



.HDLC Lines 



1 Other Line 

2 Terminals/Nodes 
Remote Stations 



xll2 = . 



. bytes 



X 264 = 264 bytes 
X 88 = 176 bytes 
X 32 = bytes 



F^ure 122. Example 9: Node 3 Line/Tenninal/Node Configuration Worksheet 



EDX Definitions 



Figure 123 on page 364 shows the EDX definitions for node 1. 



Sample Configurations 363 



*** EXAMPLE 9, NODE 1 
*** 

$EDXDEF CSECT 

SYSTEM MAXPROG=(10, 10,10,10) , PARTS= (32 , 32 , 32 , 32) , 
COMMON= ( CSXEND , CSXEND , CSXEND , CSXEND ) , 
INITMOD= (CSXINIT) 






DISK DEVICE=4962-3,ADDRESS=03, 

VOLNAME= (EDX002 , EDX003 , ASMLIB) , TASK=YES , END=YES 



LCC 
LCC 
LCC 
END 



ADDRESS=50 
ADDRESS=51 
ADDRESS=52 , END=YES 



SUBCHANNEL 
SUBCHANNEL 1 
SUBCHANNEL 2 



Figure 123. Example 9: Node 1 EDX Definitions 



Figure 124 shows the EDX definitions for either node 2 or node 3. It includes the 
definitions for remote disks and for the virtual terminals required by the remote 
management utility program. 



*** EXAMPLE 9, NODE 2 OR 3 
*** 

$EDXDEF 



CSECT 

SYSTEM MAXPROG=(10, 10,10,10) ,PARTS= (32 , 32 , 32 , 32) , 

COMMON= ( CSXEND , CSXEND , CSXEND , CSXEND ) , 

INITMOD= (CSXINIT) 



\.J 



DISK DEVICE=4962-3,ADDRESS=E1 , 

VOLNAME=(EDX002,EDX003) , TASK=NO , END=YES 



CDRVTA TERMINAL DEVICE=VIRT, ADDRESS=CDRVTB,LINSIZE=254, SYNC=YES 
CDRVTB TERMINAL DEVICE=VIRT, ADDRESS=CDRVTA,LINSIZE=254,END=YES 



LCC 

LCC 

LCC 

DEFINE 

DEFINE 

DEFINE 

END 



ADDRESS=50 SUBCHANNEL 

ADDRESS=51 SUBCHANNEL 1 

ADDRESS=52,END=YES SUBCHANNEL 2 

DEVICE , RINGADR=2F , LINE=50 , CELL=C216 , ADDRESS=E 1 
VOLUME , CELL=C1 , VOLNAME= (EDX002 , EDX002 ) 
VOLUME, CELL=C1 , VOLNAME= (EDX003 ,EDX003) ,END=YES 



Figure 124. Example 9: Node 2 or 3 EDX Definitions 



16 CELL=C3 for node 3. 
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Example 10: BSC Point-to-Point Connection with Transaction 
Processing 



Figure 125 shows a configuration in which two Series/ Is are connected by a BSC 
point-to-point line. This example includes the program dispatcher with support for 
remote disks, remote IPL, and remote management functions. Node 1 can do 
remote management of node 2 and IPL it. Node 2 can access volumes EDX002 
and EDX003 on node I's disk. 



EDX002 
EDX003 
ASMLIB 



DA = 03 



Series/ 1 

Node 1, Cell CI 



S.IOOAIO 



.PD 



' PD2 ' 

I I 

I 1 

' N0DE2 I 
l_ J 

I 



LINEl 



^ 1 



Series/ 1 

Node 2, Cell C2 


/ 




DA 
DA 


= 29 
= 29 






$.IO0A10 


LINE2 


-< — 


- -| 

1 

1 

1 
—I 

NODEl 1 

— J 

1 

PDl 1 
1 










r 




$.PD 


1 










r 
1 

L. 



u J 



Figure 125. Example 10: BSC Point-to-Point Connection mth Transaction Processing 



The example doesn't include Communications Facility terminals or communication 
with a host system; you could, of course, add them to such a configuration. 
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Message Flow 



The routing of messages between nodes connected by a BSC point-to-point line is 
explained in example 6. Be sure you understand that example before you study this 
one. 

Look at Figure 126, the program dispatcher data sets. The path stations are those 
that represent the remote program dispatchers. 






*** EXAMPLE 10, CELL CI 
SET LOG $SYSPRTR 
SET NODE 0100 
S LINE1 LINE2 

/* 

CELL CI 
PATH PD2,C2 

/* 

TID <I0> $.PD<IO>,,,N 32 

TID IPL $.PDIPL 22 

TID HMU $.HMU 22 

/* 

SYST** MS********CELL CI IS OPERATIONAL 

/* 

*** EXAMPLE 10, CELL C2 
SET LOG $SYSPRTR 
SET NODE 0200 
S LINE1 LINE2 

/* 

CELL C2 

PATH PD1 ,C1 P 

/* 

TID RMU $.RMU 22 

/* 

SYST SPE1C1 

SYST** MS********CELL C2 IS OPERATIONAL 

SYSTC1 CP PD T C2 

/* 



Figure 126. Example 10: Program Dispatcher Data Sets 



A transaction with primary cell identifier C2 that originates in cell CI is routed as 
follows: 

1. The program dispatcher in cell CI receives the transaction, determines that the 
path to cell C2 is station PD2, and sends the transaction to that station. 

2. PD2 is a remote station (its network address, 02AB, is not in this node), so 
node I's message dispatcher finds the station whose network address is 0200, 
NODE2. Station NODE2 is a vector station, so the message dispatcher puts 
the message on the queue of its link, LINEl. 

3. Subsequently, $.IO0A10 retrieves the message from LINEl 's queue and sends 
it over the BSC line. 






4. $.IO0A10 in node 2 reads the data and sends it to the message dispatcher. 
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5. The message header shows that the destination network address (02 AB) is in 
the local node, so the message dispatcher puts the message on the queue of the 
station with that network address, $.PD. 

6. The program dispatcher retrieves the transaction from its queue, determines 
that it is to be processed in this cell, and routes it according to the primary 
transaction identifier. 






Program Dispatcher Data Sets 



Figure 126 on page 367 shows the program dispatcher data set ($.SYSPD) for 
each of the two cells. The commands in the first part of each data set assign 
$SYSPRTR as the Communications Facility log, set the node assigrmient, and start 
the local and remote line stations. You don't have to start the path stations; the 
program dispatcher does that when it's started. If you put the SET NODE 
command in $.SYSPD as shown here, be sure that you start the program dispatcher 
before starting any remote stations in your configuration. 

The second part of each data set defines the local cell and the path to the remote 
cells. The remainder of each data set is the same as in example 8. See that 
example for an explanation of the TID statements and transactions. 



IPL Transaction Data Set 



Station Definitions 



An IPL transaction data set ($.SYSLCC) is required in cell CI, because that 

contains the definition of transaction IPL. The data set won't be used (it's used 

only for Local Communications Controller hardware IPL requests), so it can be a 

small empty data set. ( , 



Figure 127 on page 369 through Figure 130 on page 372 show the station 
definitions for this example. 



o 
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User I Message I Alias /Volume Configuration Worksheet 



System; Example 10: BSC Point- to- Point with Transactions, Node 1 
Node Assignment: 01 



Description 


Name 


NA 


Type 


Alias' 


Series/l-Series/l lOCP 


S.IOGAIO 


OlAA 


USER 




Program dispatcher 


$.PD 


OlAB 


USER 




Program dispatcher in node 2 


PD2 


02AB 


USER 





Specify only for alias station 



SSFOOL Storage 



2 User/Msg Stations 
Alias Stations 



X 88 = 176 bytes 
X 40 = bytes 



1 Remote Station x 32 = 32 bytes 
Volume Stations x 104 = bytes 

Figure 127. Example 10: Node 1 User /Message /Alias/Volume Configuration Worksheet 
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Line I Terminal I Node Configuration Worksheet 



System: Example 10: BSC Point-to-Point with Transactions, Node 1 
Node Assignment: 01 



/If ^, 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window* 


BSC line 


LINEl 


0129 


LINE 


CPU 


2500 









Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name* 


Polling 

CUDAV 

Portr 


Select 
CUDA' 


Node 2 


NODE2 


0200 


NODE 


CF 













' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
' Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 

* Specify only for port terminal station 

' Specify only for DCE or DTE line station 

* Specify only for PC node station 






S$POOL Storage 



-HDLC Lines 



xll2 = 



bytes 



1 Other Line x 264 = 264 bytes 

Terminals/Nodes x 88 = bytes 

1 Remote Station x 32 = 32 bytes 

Figure 128. Example 10: Node 1 Line/Terminal/Node Connguration Workdieet 



o 
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User /Message /Alias /Volume Configuration Worksheet 



System: Example 10: BSC Point- to-Point with Transactions, Node 2 
Node Assignment: 02 



Description 


Name 


NA 


Type 


Alias' 


Series/ 1 -Series/ 1 lOCP 


S.IOOAIO 


02AA 


USER 




Program dispatcher 


$.PD 


02AB 


USER 




Program dispatcher in node 1 


PDl 


OlAB 


USER 





' specify only for alias station 



SSFOOL Storage 



2 User/Msg Stations 

Alias Stations 

1 Remote Station 
Volume Stations 



X 88 = 176 bytes 

X 40 = bytes 

X 32 = 32 bytes 

X 104 = bytes 









Figure 129. Example 10: Node 2 User/Message/ Alias/Volume Configuration Worksheet 
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Line /Terminal I Node Configuration Worksheet 



System: Example 10:' BSC Point-to-Point with Transactions, Node 2 
Node Assignment: 02 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Pacliet Size' 


Window' 


BSC line 


LINE2 


0229 


LINE 


CPU 


2500 












Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name* 


Polling 

CUDAV 

Portr 


Select 
CUDA» 


Nodel 


NODEl 


0100 


NODE 


CF 













' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
" Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 






S$POOL Storage 



-HDLC Lines 



xll2 = . 



. bytes 



1 Other Line x 264 = 264 bytes 

Terminals/Nodes x 88 = bytes 

1 Remote Station x 32 = 32 bytes 

Fl^e 130. Example 10: Node 2 Line/Terminal/Node Conflguration Worksheet 



EDX Definitions 



Figure 131 on page 373 shows the EDX definitions for node 1. 
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*** EXAMPLE 10 NODE 1 

$EDXDEF CSECT 

SYSTEM MAXPROG=(10,10,10, 10) , PARTS= (32 , 32 , 32 , 32) , 
COMMON= ( CSXEND , CSXEND , CSXEND , CSXEND ) , 
INITMOD= (CSXINIT) 



DISK DEVICE=4962-3,ADDRESS=03, 

VOLNAME= (EDX002 , EDX003 , ASMLIB) , TASK=YES , END=YES 



BSCLINE ADDRESS=29,TYPE=PT,END=YES SERIES/ 1 -SERIES/ 1 
END 



F^e 131. Example 10: Node 1 EDX Definitions 



Figure 132 shows the EDX definitions for node 2. It includes the definitions for 
remote disks and for the virtual terminals required by the remote management 
utility program. 



*** EXAMPLE 10, NODE 2 
$EDXDEF 






CSECT 

SYSTEM MAXPROG=(10,10,10,10) , PARTS= (32 , 32 , 32 , 32) , 

COMMON= ( CSXEND , CSXEND , CSXEND , CSXEND ) , 

INITMOD= (CSXINIT) 



DISK DEVICE=4962-3,ADDRESS=E1 , 

VOLNAME= (EDX002 , EDX003 ) , TASK=NO , END=YES 



CDRVTA TERMINAL DEVICE=VIRT, ADDRESS=CDRVTB, LINSIZE=254 , SYNC=YES 
CDRVTB TERMINAL DEVICE=VIRT, ADDRESS=CDRVTA, LINSIZE=254 ,END=YES 



BSCLINE 

DEFINE 

DEFINE 

DEFINE 

END 



ADDRESS=29,TYPE=PT,END=YES SERIES/1 -SERIES/1 
DEVICE , CUDA=0 , LINE=29 , CELL=C2 , ADDRESS=E 1 
VOLUME , CELL=C 1 , VOLNAME= ( EDX002 , EDX002 ) 
VOLUME, CELL=C1 , VOLNAME= (EDX003 ,EDX003) ,END=YES 



Figure 132. Example 10: Node 2 EDX Definitions 
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Example 11: Multiple Local Communications Controller and BSC 
Connections 

Figure 133 on page 375 shows a configuration in which six Series/ Is are 
connected by two Local Communications Controller rings and a BSC 
point-to-point line. One of the Series/ Is is a Communications Manager node; the 
other five are Communications Facility nodes. The stations shown in the diagram 
enable communication between any two nodes. 






Message Flow 



Before you study this example, be sure you understand how messages are routed 
between nodes connected by a single Local Communications Controller ring 
(example 5) and between nodes connected by a BSC point-to-point line (example 
6). This example presents only one new concept — how messages are routed to a 
node that is accessible from, but not connected to, the origin node. Although the 
example only shows BSC and Local Communications Controller connections, such 
a configuration could also include HDLC connections. As explained in "Example 
12: X.25 Connection between Series/Is" and "Example 13: X.25 Connection 
Between Series/ Is through an X.25 Network," the routing of messages between 
nodes connected by or accessed from an HDLC Une is essentially the same as when 
nodes are connected by a BSC point-to-point line. Only the definitions of the 
stations that represent the physical connection and the actions of the lOCP that 
manages the connection are different. 

Consider the configuration from the viewpoint of node A. Nodes B and C are 
connected to the same ring as node A. Nodes D and E are on a different ring that 
can be accessed through node C. Node F is not connected to any ring, but it can 
be accessed through nodes C and D. 

Look at Figure 134 on page 376, the line and node station definitions for node A. 
Notice that nodes D, E, and F are defined as node stations with no ring address or 
line name. Vector (not node) station blocks are created when these stations are 
started. A message sent to a station in node D is put on the queue of the station 
that DNODE is Unked to, as explained in example 6. When you define nodes 
accessible from, but not on, the same ring, you must Unk them to the node station 
through which they can be accessed. 

This example includes a Communications Manager node, so the node assignments 
must be the hexadecimal representation of an alphabetic character; node A is CI, 
node B is C2, and so on. To the Communications Manager, the nodes would be 
known by the names AA, BB, and so on. Any stations that will send messages to 
or receive messages from the Communications Manager must have names no 
longer than 4 characters. That rule doesn't apply to the stations shown in this 
example, because they aren't the origin or destination of messages; they are just 
used to route messages from one node to another. 

Let's see how messages are routed over the longest path, from node A to node F. 
Assume that a message originates from some station in node A and has a 
destination address of some station in node F, say C699. The message is routed as 
follows: 

1. In node A, the message dispatcher puts the message on the queue of the station 
to which the vector station with network address C600 is linked, CNODE. 






o 
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Node A 



NodeB 



I DNODE I • ENODE ' I FNODE I 
I ^ I I J I I ,^ 1 



CNODE 



$.IO0AB0 



BNODE 



RING 



DA = 50 



IF 



r II II -1 


1 

L 


DNODE 1 ' ENODE 


1 ' FNODE ' 
-1 L_^ _ J 




ANODE 


CNODE 










RING 


S.IOOABO 




^^ 


DA = 50 






\ 
















NodeC 



ANODE 



BNODE 



DNODE 



ENODE 



I FNODE • 



NodeE 



COMMUNICATIONS 

MANAGER 

SYSTEM 



RINGl 



RING2 



4F 
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Figure 133. Example 11: Multiple Local Communications Controller and BSC Connections 






$.100 ABO retrieves the message and sends it over the Local Communications 
Controller ring. 
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Line / Terminal / Node Configuration Worksheet 



z'^., 



System: Example 1 1 : Multiple Rings and BSC Connections, Node A , Node 3 
Node Assignment: CI 

Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


Local Communications 
Controller Ring 


RING 


CICO 


LINE 


LCC 


2500 


50 







Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address^ 


Line Name 


Volume 
Name' 


Polling 
CUDAV 

Portr 


Select 
CUDA' 


NodeB 


BNODE 


C200 


NODE 


CF 


2F 


RING 








NodeC 


CNODE 


C300 


NODE 


CF 


4F 


RING 








NodeD 


DNODE 


C400 


NODE 


CF 












NodeE 


ENODE 


C500 


NODE 


CM 












NodeF 


FNODE 


C600 


NODE 


CF 
















' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
" Specify only for port terminal station 
^ Specify only for DCE or DTE line station 
' Specify only for PC node station 



S$POOL Storage 



.HDLC Lines 



1 Other Line 

2 Terminals/Nodes 

3 Remote Stations 



X 112 = . 



bytes 



X 264 = 264 bytes 
x88 = 176 bytes 
X 32 = 96 bytes 



Figure 134. Example 11: Node A Line/Terminal/Node Configuration Worksheet 



2. In node C, $.100 ABO reads the data and passes it to the message dispatcher. 
The message dispatcher puts the message on the queue of the station to which 
the vector station with network address C600 is linked, DNODE. $.100 ABO 
retrieves the message and sends it over the second ring (because station 
DNODE is associated with line station RING2, whose device address is A8). 



^ — 



J 
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Station Definitions 






3. In node D, $.IO0AB0 reads the data and passes it to the message dispatcher. 
The message dispatcher puts the message on the queue of the station to which 
the vector station with network address C600 is linked, BSCLINE. $.IO0A10 
retrieves the message and sends it over the BSC line. 

4. In node F, $.IO0A10 reads the data and passes it to the message dispatcher. 
The message dispatcher puts the message on the queue of the destination 
station, the one with network address C699. 



Figure 134 on page 376 through Figure 138 on page 381 show the Une and node 
station definitions for the five Communications Facility nodes. 

As shown in earlier examples, you must also define the stations that send and 
receive messages and the remote stations to which local stations send messages. 
Assume, for example, that a terminal in node A communicates with an application 
program in node F. You must define the application program as a remote station in 
node A and the terminal as a remote station in node F. You don't need to define 
either station in the intermediate nodes through which messages are routed. 
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Line / Terminal / Node Configuration Worksheet 



\^ 



System: Example 1 1 : Multiple Rings and BSC Connections, Node B , Node 3 
Node Assignment: C2 

Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


Local Communications 
Controller Ring 


RING 


C2C0 


LINE 


LCC 


2500 


50 







Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address^ 


Line Name 


Volume 
Name' 


Polling 
CUDAV 

Port#* 


Select 
CUDA' 


Node A 


ANODE 


ClOO 


NODE 


CF 


IF 


RING 








NodeC 


CNODE 


C300 


NODE 


CF 


4F 


RING 








NodeD 


DNODE 


C400 


NODE 


CF 












NodeE 


ENODE 


C500 


NODE 


CM 












NodeF 


FNODE 


C600 


NODE 


CF 













' specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
^ Specify only for 3271, 3277, or 3286 terminal station 
" Specify only for port terminal station 
* Specify only for DCE or DTE line station 
^ Specify only for PC node station 



SSPOOL Storage 



-HDLC Lines 



1 Other Line 

2 Terminals/Nodes 

3 Remote Stations 



X 112^ 



bytes 



X 264 = 264 bytes 
x88= 176 bytes 
X 32 = 96 bytes 



Figure 135. Example 11: Node B Line/Tenninal/Node Configuration Worksheet 
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Line / Terminal / Node Configuration Worksheet 



^**\ 
\^' 



System: Example 11: Multiple Rings and BSC Connections, Node C , Node 3 
Node Assignment: C3 

Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


Local Communications 
Controller Ring 1 


RINGl 


C3C0 


LINE 


LCC 


2500 


50 






Local Communications 
Controller Ring 2 


RING2 


C3C1 


LINE 


LCC 


2500 


A8 







Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name' 


Polling 

CUDAV 

Portijl* 


Select 
CUBA' 


Node A 


ANODE 


ClOO 


NODE 


CF 


IF 


RINGl 








NodeB 


BNODE 


C200 


NODE 


CF 


2F 


RINGl 








NodeD 


DNODE 


C400 


NODE 


CF 


4F 


RING2 








NodeE 


ENODE 


C500 


NODE 


CM 


IF 


RING2 








NodeF 


FNODE 


C600 


NODE 


CF 













' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
■* Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 



SSPOOL Storage 



-HDLC Lines 



2 Other Lines 

4 Terminals/Nodes 

1 Remote Station 



X 112 



bytes 



X 264 = 528 bytes 
X 88 = 352 bytes 
X 32 = 32 bytes 



Figure 136. Example 11: Node C Line/Terminal/Node Configuration Worksheet 
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Line /Terminal /Node Configuration Worksheet 



System: Example 1 1 : Multiple Rings and BSC Connections, Node D , Node 3 
Node Assignment: C4 

Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


Local Communications 
Controller Ring 


RING 


C4C0 


LINE 


LCC 


2500 


50 






BSC line 


BSCLINE 


C429 


LINE 


CPU 


2500 









Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name' 


Polling 

CUDAV 

Portr 


Select 
CUDA' 


Node A 


ANODE 


ClOO 


NODE 


CF 












NodeB 


BNODE 


C200 


NODE 


CF 












NodeC 


CNODE 


C300 


NODE 


CF 


2F 


RING 








NodeE 


ENODE 


C500 


NODE 


CM 


IF 


RING 








NodeF 


FNODE 


C600 


NODE 


CF 
















' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
" Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 



o 



SSPGOL Storage 



.HDLC Lines 



2 Other Lines 

2 Terminals/Nodes 

3 Remote Stations 



X 112 = 



, bytes 



X 264 = 528 bytes 
x88 = 176 bytes 
X 32 = 96 bytes 



Figure 137. Example 11: Node D Line/Terminai/Node Configuration Worksheet 
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Line /Terminal /Node Configuration Worksheet 



System: Example 11: Multiple Rings and BSC Connections, Node F , Node 3 
Node Assignment: C6 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


BSC line 


BSCLINE 


C629 


LINE 


CPU 


2500 









Terminal and Node Definitions 






Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address^ 


Line Name 


Volume 
Name' 


Polling 

CUDAV 

Port#* 


Select 
CUDA' 


Node A 


ANODE 


ClOO 


NODE 


CF 












NodeB 


BNODE 


C200 


NODE 


CF 












NodeC 


CNODE 


C300 


NODE 


CF 












NodeD 


DNODE 


C400 


NODE 


CF 












NodeE 


ENODE 


C500 


NODE 


CM 













' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
■• Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 



SSPOOL Storage 



-HDLC Lines 



1 Other Line 

Terminals/Nodes 

5 Remote Stations 



X 112 = , 



bytes 



X 264 = 264 bytes 

X 88 = bytes 

x32= 160 bytes 



Figure 138. Example 11: Node F Line/Terminal/Node Configuration Worksheet 
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Example 12: X.25 Connection between Series/ Is 



Figure 139 on page 383 shows a configuration in which two Series/ Is are 
connected by an HDLC line. The application program in node 1 communicates 
with users at 3101 terminals in either node. The 3101 terminals are attached to the 
Series/ Is by feature programmable communications adapters. 



/" fi^ 



You can use such a configuration for transaction processing by defining local and 
remote program dispatcher stations in each Series/ Is, as shown in "Example 10: 
BSC Point-to-Point Connection with Transaction Processing" on page 366. 
However, you cannot use remote disk or remote IPL over an X.25 connection. 



Configuration Description 



Look at the station definition worksheets for example 12. Each node has a unique 
node assignment, and there are definitions of all remote stations to which local 
stations will send messages. 

In each node, the remote node is defined as a node station with no ring address or 
line name. The circuit usage is CF, and the circuit stations in the two nodes have 
the same logical channel ID (LCI), as is required for proper message routing. The 
line station in one node is subtype DCE, and the line station in the other node is 
subtype DTE, as required when there is no X.25 packet-switching network 
between the two nodes. The circuit station subtype is PVC; this is the only circuit 
supported by the Communications Facility with DCE Une stations. 

When these stations have been defined, Unked as in Figure 139 on page 383, and 
started, a display of the started stations in node 2 shows this information: 






STATION 


TYPE 


NA 


LINK 


$.DISP 


0000 


0200 


0000 


LINE2 


0AB8 


0270 


0000 


CIRC2 


16BD 


02C2 


0000 


NODEI 


0800 


0100 


02C2 


APROG 


0800 


01 AC 


0000 


TERM2A 


06F0 


0260 


01AC 


TERM2B 


06F0 


0261 


01 AC 


Notice that: 









The network address of $.DISP (the system station) shows that the node 
assignment is 02. This is the result of issuing a CP SET NODE command. 

The remote station (APROG) has a vector station block (type 08). This is the 
result of starting a station whose type is other than NODE and whose network 
address is not in this node. 

The node station (NODEI) has a vector station block (type 08). This is the 
result of starting station whose type is NODE, but which doesn't have an 
associated line station. 



\.J 
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\J 



Series/ 1, Node 1 





DA = 60 




$.1006 FO 








1 1 
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1 J 
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DA = 61 
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Figure 139. Example 12: X.2S Connection between Series/ Is 



Message Flow 



%J 



The flow of messages between the terminals in node 1 and the application program 
is as described for example 5. The flow of messages between nodes 1 and 2 is 
similar to that described for example 6. 

A message from TERM2A is routed to the application program in node 1 as 
follows. The 3101 lOCP, $.IO06F0, sends the message to the origin station's link, 
APROG, whose network address is 01 AC. The message dispatcher determines 
that the address is not in this node, sets the second byte to 00, and looks for a 
station with that network address (0100). Station NODEl satisfies the search. 



Sample Configurations 383 



NODEl is a vector station, so the message dispatcher puts the message on the 

queue of the station to which NODEl is linked. That station is the one with 

network address 02C2 (CIRC2). ^X 



X.25 CaU ID Data Set 



V 



./ 



The method of routing messages between nodes accounts for the restriction that 
you can't have more than one active connection (BSC point-to-point, Local 
Communications Controller, or X,25) through circuit stations with usage CF 
between two Series/ Is. For all these connections, a station with network address 
nnOO is required to route messages to node nn, and you can't start more than one 
station with a given network address. 

Subsequently, the X.25 lOCP, $.IO0AB8, retrieves the message from CIRC2's 
queue and transmits it over the HDLC Une represented by LINE2. It writes the 
message over logical channel 001, as specified in the definition of station CIRC2. 
It writes the message header, as well as the message data, because CIRC2's usage 
is CF. $.100 AB8 in node 1 reads the message from logical channel 001 and finds 
the circuit station with that logical channel ID (CIRCl). CIRCl's usage is CF, so 
$.IO0AB8 sends the message with its header to the message dispatcher. The 
routing information in the message header shows that the origin is 0260 and the 
destination is 01 AC. The message dispatcher determines that the destination 
network address is in this node, so it puts the message on APROG's queue. The 
response from APROG to TERM2A is routed in a similar manner. 

In summary, to enable communication between nodes connected by an X.25 
connection, you must: 

• Give each node a unique node assignment. 

• In each node, define the remote stations to which local stations will send (^^ 
messages. Be sure that the network address is the same as that of the \^ 
corresponding real station in the remote node. The station names need not be 

the same. 

• Define the line in one node as subtype DCE and the line in the other node as 
subtype DTE. 

• In each node, define a PVC circuit station with usage CF. Be sure that the two 
circuit stations have the same logical channel ID. 

• In each node, define the remote node station and Unk it to the circuit station. 

• When you start the Communications Facility, issue a CP SET NODE 
command to set the node assignment before starting any remote stations. 



An X.25 call ID data set ($.SYSX25) is required in each node, even though it is not 
used for permanent virtual circuits. It is used for switched virtual circuit call 
establishment. The data set contains one record of /*. 



o 
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Station Definitions 






Figure 140 through Figure 147 on page 389 show the station definitions for the 
two nodes in this configuration. 



User/ Message /Alias /Volume Configuration Worksheet 



System: Example 12: X.25 Connection between Series/ Is, Node 1 
Node Assignment: 01 



Description 


Name 


NA 


Type 


Alias' 


3101-FPCAIOCP 


$.1006 FO 


OlAA 


USER 




X.25 lOCP 


$.IO0AB8 


OlAB 


USER 




Application program 


APROG 


OlAC 


USER 





Specify only for alias station 



SSPOOL Storage 






3 User/Msg Stations 

Alias Stations 

Remote Stations 

Volume Stations 



X 88 = 264 bytes 

X 40 = bytes 

X 32 = bytes 

X 104 == bytes 



Figure 140. Example 12: Node 1 User/Message/ Alias/ Volume Configuration Worksheet 
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Device Configuration Worksheet 



^f~\ 



System: Example 12: X.25 Connection between Series/ Is, Node 1 
Node Assignment: 01 



Description 


Name 


NA 


Type 


Device Type 


Buffer 
Size 


FDS' 


Polling 
CUDA 


Selection 
CUDAV 
HDCPY' 


Bit Rate' 


Auto 
Ans' 


3101 


TERMIA 


0160 


DEVICE 


3101F 


2500 




4040 


SSYSFRTR 


4800 


Y 


3101 


TERM IB 


0161 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


4800 


Y 


Remote 3101 


TERM2A 


0260 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


4800 


Y 


Remote 3101 


TERM2B 


0261 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


4800 


Y 



' Specify only for printer device station 
^ Specify only for printer or 4978 device station 
' Specify only for 3101 or 31 OIF device station 
"* Specify only for 3 101 F device station 
For 7485s, bit rate must be 9600 and AUTO ANS=NO 



SSPOOL Storage 



2 3 1 1 F Devices x 1 60 = 320 bytes 

4978/Printer Devices x 264 = bytes 

3101 Devices x 304 = bytes 



2 Remote Stations 



X 32 = 64 bytes 






Figure 141. Example 12: Node 1 Device Configuration Worksheet 
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Line /Terminal /Node Configuration Worksheet 



System: Example 12: X.25 Connections between Series/ Is, Node 1 
Node Assignment: 01 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


HDLC Line 


LINEl 


0170 


LINE 


DCE 


2526 




128 


2 



Terminal and Node Definitions 






Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name' 


Polling 

CUDAV 

Portr 


Select 
CUDA' 


Remote Node 


NODE2 


0200 


NODE 


CF 













' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
" Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 



SSPOOL Storage 

1 HDLC Line x 1 12 = 112 bytes 

Other Lines x 264 = bytes 

Terminals/Nodes x 88 = bytes 

1 Remote Station x 32 = 32 bytes 



Figure 142. Example 12: Node 1 Line/Terminal/Node Configuration Worksheet 



Circuit Configuration Worksheet 



System: Example 12: X.25 Connection between Series/ Is, Node 1 
Node Assignment: 01 



PVC Circuit Definition 



Description 


Name 


NA 


Type 


Circuit Type 


Line 


Usage 


LCI 


PVC Circuit 


CIRCl 


OlCl 


CIRC 


PVC 


LINEl 


CF 


001 



o 



SSPOOL Storage 
1 Circuit X 128 = 128 bytes 

Figure 143. Example 12: Node 1 Circuit Configiu-ation Worksheet 
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User /Message /Alias /Volume Configuration Worksheet 



System: Example 12: X.25 Connection between Series/ Is, Node 2 
Node Assignment: 02 



' Specify only for alias station 



S$POOL Storage 



2 User/Msg Stations 
Alias Stations 



X 88 = 176 bytes 
X 40 = bytes 



1 Remote Station x 32 = 32 bytes 
Volume Stations x 104 = bytes 



Figure 144. Example 12: Node 2 User /Message/ Alias/Volume Configuration Worksheet 



Device Configuration Worksheet 



System: Example 12: X.25 Connection between Series/ Is, Node 2 
Node Assignment: 02 






Description 


Name 


NA 


Type 


Alias* 


3101-FPCAIOCP 


$.IO06F0 


02AA 


USER 




X.25 lOCP 


S.IOOABB 


02AB 


USER 




Remote application program 


APROG 


OlAC 


USER 





\J 



Description 


Name 


NA 


Type 


Device Type 


Buffer 
Size 


PDS' 


Polling 
CUDA 


Selection 
CUDAV 
HDCPY' 


Bit Rate' 


Auto 
Ans' 


3101 


TERM2A 


0260 


DEVICE 


3101F 


2500 




4040 


SSYSFRTR 


4800 


Y 


3101 


TERM2B 


0261 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


4800 


Y 



' Specify only for printer device station 
^ Specify only for printer or 4978 device station 
' Specify only for 3101 or 31 OIF device station 
" Specify only for 3 101 F device station 
For 7485s, bit rate must be 9600 and AUTO ANS=NO 



SSPOOL Storage 



2 3101F Devices x 160 = 320 bytes 

4978/Printer Devices x 264 = bytes 

3 1 1 Devices x 304 = bytes 

Remote Stations x 32 = bytes 



Figure 145. Example 12: Node 2 Device Configuration Worksheet 



^Ihto*-*'^ 
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Line I Terminal / Node Configuration Worksheet 



System: Example 12: X.25 Connection between Series/ Is, Node 2 
Node Assignment: 02 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


HDLC Line 


LINE2 


0270 


LINE 


DTE 


2526 




128 


2 



Terminal and Node Definitions 






Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name' 


Polling 

CUDAV 

Portr 


Select 
CUDA' 


Remote Node 


NODEl 


0100 


NODE 


CF 













' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
* Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 



SSPOOL Storage 

1 HDLC Line x 112 = 112 bytes 

Other Lines x 164 = bytes 

Terminals/Nodes x 88 = bytes 

1 Remote Station x 32 = 32 bytes 



Figure 146. Example 12: Node 2 Line/Terminal/Node Configuration Workslieet 



Circuit Configuration Worksheet 



System: Example 12: X.25 Connection between Series/ Is, Node 2 
Node Assignment: 02 



PVC Circuit Definition 



Description 


Name 


NA 


Type 


Circuit Type 


Line 


Usage 


LCI 


PVC Circuit 


CIRC2 


02C2 


CIRC 


PVC 


LINE2 


CF 


001 



SSPOOL Storage 
1 Circuit x 128 = 128 bytes 

Figure 147. Example 12: Node 2 Circuit Configuration Worksheet 
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EDX Definitions 



Figure 148 shows the EDX definitions for either node in this example. Notice that 
the 3101s are not defined to EDX, so they can be used only as Communications 
Facility terminals. If you also want to use them as EDX terminals, use 
TERMINAL statements to define them. 

Note that the label of the XHCDEV statement must be the same as the line station 
name and must be six characters or less. To use the EDX definitions for NODE2, 
just change LINEl to LINE2. 



*** EXAMPLE 12, NODE 1 

$EDXDEF CSECT 

SYSTEM MAXPROG=(10,10, 10, 10) ,PARTS=(32,32,32,32) , X 

COMMON= ( CSXEND , CSXEND , CSXEND , CSXEND ) , X 

INITMOD= (CTZOII , CSXINIT) 

• 

$SYSPRTR TERMINAL DEVICE=4973 , ADDRESS=0 1 , END=YES 

LINEl XHCDEV* (71 , 70) , ADAPTER=2080 ,END=YES 
END 



Figure 148. Example 12: EDX Definitions 



/if^x 
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Example 13: X.25 Connection Bet#e^n Series/Is through an X.25 
Network 

Figure 149 on page 393 shows a configuration in which three Series/ Is are 
connected by HDLC lines through an X.25 packet-switching network. The 
application program in node 1 communicates with with users at 3101 terminals in 
any of the nodes. The 3101 terminals are attached to the Series/ Is by feature 
programmable communications adapters. 

You can use such a configuration for transaction-processing by defining local and 
remote program dispatcher stations in each Series/ 1, as shown in " Example 9: 
Local Communications Controller Connection with Transaction Processing" on 
page 354. However, you cannot use remote disk or remote IPL over an X.25 
connection. 






Configuration Description 



Figure 153 on page 396 through Figure 164 on page 404 show the station 
definitions for this example. As for example 12, all the circuit stations are defined 
with usage=CF, each node has a unique node assignment, and there are definitions 
of all remote stations to which local stations sends messages. The differences 
appear in the $.SYSX25 definition, the line/terminal/node configuration 
worksheets and the circuit configuration worksheets. The line stations all have 
subtype DTE; this is required when the connection is through an X.25 
packet-switching network. 

The most important difference between example 12 and example 13 is that the /-T^X 

circuit stations in example 12 are of subtype PVC while the circuit stations in 'j J 

example 13 are of subtype SVC. In example 12, the connection between the nodes 

is through the specification of the same logical channel ID (LCI). With SVC 

circuit stations, the logical channel used is assigned by XHCS and the connection 

between logical channels is done by the X.25 network. This logical connection, or 

virtual call, must be established before messages can flow correctly. 

Notice that: 

• CIRCIA and CIRCIB are defined with contact=INIT; the X.25 lOCP, 
$.100 AB8 sends a call request packet to the network when these stations are 
started. 

• CIRCIA has call ID of 2, which is associated with node 2's X.25 network 
address. CIRCIB has call ID of 3, which is associated with node 3's X.25 
network address. CIRCIA represents the logical connection between nodes 1 
and 2; CIRCIB represents the logical connection between nodes 1 and 3. 

• CIRC2A and CIRC3B are defined with contact=WAIT; when they are 
started, $.100 AB8 waits for an incoming call packet from the X.25 network. 
Because both CIRC2A and CIRC3B have call ID of 0. $.100 AB8 accepts a 
call from any X.25 network address. 

• CIRC2B like CIRC2A, is defined with contact=WAIT and call ID of 0. 
However, they are defined with different protocol ID's. CIRC2A has the same 
protocol ID as CIRCIA; the result is that the virtual call is made between node ^^ 
1 and 2 over CIRC 1 A and CIRC2A instead of CIRC 1 A and CIRC2B. W 
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Series/ 1, Node 1 



o 








DA = 60 


$.iO06F0 










1 


TERM2A 


3101 




L _J 


TERM 1 A 




r 

TFRM2R 




DA = 61 




APROG 


TFRM'^A 


3101 


TERM IB 










r^ 1 




r 


N0DE2 "^ "" N0DE3 "^ | ^^^^^^ 




Li. 


CIRCIA 


CIRCIB 


^J 










$.IO0AB8 


LINEl 





X.25 Network Address 
1234567822 



Series/ 1, Node 2 



DA = 70 



X.25 Network Address 
1234567811 






$.IO0AB8 


LINE2 












CIRC2A 


CIRC2B 




r 

1 

1 


i 

--n r-'-n 

APROG NODEl 

1 
1 






TERM2A 


TERM2B 


$.IO06F0 








DA = 60 


DA = 61 






3101 




3101 





X.25 Network Address 
1234567833 



Series/ 1, Node 3 



LINE3 



CIRC3B 



$.IO0AB8 



NODEl 



I 1 

APROG 



$.IO06F0 



TERM3A 



DA = 60 



TERM3B 



DA = 61 



3101 



3101 






F^ure 149. Example 13: X.25 Connection between Series/Is through an X.25 Network 
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Establishing Virtual Calls 



Message Flow 



When these stations have been defined, linked as in Figure 148 on page 390, and 

started, the logical connection between node 1 and node 2 is established as follows: /lf"^ 

• When CIRC2A is started, $.IO0AB8 waits for an incoming call packet from 
the X.25 network. $.IO0AB8 accepts a call from any X.25 network address 
with the protocol ID as specified in CIRC2A's station block. 

• When CIRCIA is started, $.IO0AB8 sends a call request packet to the X.25 
network. The X.25 network address associated with call ID 2 and the protocol 
ID defined in CIRClA's station block is sent on the call request packet. 

• When the X.25 network receives the call request packet, it determines the path 
to node 2 (using the X.25 network address on the call request packet) and 
sends an incoming call packet to node 2. 

• $.IO0AB8 in node 2 receives the incoming call packet for CIRC2A because 
CIRC2A's protocol ID matches the protocol ID on the incoming call. 
$.IO0AB8 accepts the call by sending a call accept packet to the network. 

• When the X.25 network receives the call accept packet, it sends a call 
connected packet to node 1. At this point the virtual call is established. 

The connection between node 1 and 3 is established in a similar way. 

If the connection between node 2 and the X.25 network is not ready when the call 

request packet is received by the X.25 network, the network clears the call by 

sending a clear indication packet to the calling node. If CIRC2A is not active . — . 

when the incoming call packet is received, XHCS clears the call. If CIRCIA is in 

RETRY mode, $.IO0AB8 keeps sending the call request packet until the virtual 

call is established or the circuit station is stopped. If CIRCIA is in STOP mode, 

the circuit station is stopped. 



\J 



After the virtual calls are estabUshed, a message from TERM2A or TERM3A is 
routed to the application program in the same way as in example 12. 

In summary, to enable communication between nodes over an X.25 
packet-switching network, you must: 

• Give each node a unique node assignment. 

• In each node, define the remote stations to which local stations sends 
messages. Be sure that the network address is the same as that of the 
corresponding real station in the remote node. The station names need not be 
the same. 

• In each node, define the node station to which the local node is connected. Do 
not specify ring address or line name. Link the remote node to the circuit 
station that represents the logical connection to the remote node. 

• Edit $.SYSX25 to include the call IDs and their associated X.25 network d^\ 
addresses. ■ J 
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X.25 CaU ID Data Set 






O 



In each node, define the line station with subtype DTE. 

Decide wliich node will initiate virtual call establishment. Define the circuit 
station in this node with contact=INIT. Specify the call ID of the remote node 
and the protocol ID required by the circuit station in the remote node. Define 
the circuit station in the remote node with contact=WAIT and either the call 
ID of the local node or if incoming call packets can be received from any 
X.25 network address. If there are two or more circuit stations with 
contact=WAIT, define a unique protocol ID to separate incoming call packets. 

When you start the Communications Facility, issue a CP SET NODE 
command to set the node assignment before starting any remote stations. 

Start the circuit stations with contact=WArr before starting those with 
contact=INIT. Otherwise use the CP F MODE command to put the circuit 
stations with contact=INIT into RETRY mode. 



An X.25 call ID data set ($.SYSX25) is required in aU three nodes for use by the 
X.25 lOCP, as in Figure 150. Node I's circuits initiate calls to two different call 
IDs, so both must be included in its $.SYSX25 data set. Node 2's circuit is defined 
with call ID 0, so it doesn't require a call ID in its data set. (But it still must have a 
$.SYSX25 data set.) Node 3's circuit waits for a call from call ID 1, so its 
$.SYSX25 data set must include call ID 1. 



2 Node2 1234567822 San Francisco shipping 

3 Node3 1234567833 Tokyo warehouse 

/* 

Figure 150. Example 13: Node 1 $.SYSX25 Data Set 



/* 

Figure 151. Example 13: Node 2 $.SYSX25 Data Set 



1 Nodel 1234567811 Sydney shipping 

/* 

Figure 152. Example 13: Node 3 $.SYSX25 Data Set 
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Station Definitions 



Figure 153 through Figure 164 on page 404 show the station definitions for this 
example. 



User /Message /Alias /Volume Configuration Worksheet 

System: Example 13: X.25 Connection between Series/ Is through an X.25 Network, Node 1 
Node Assignment: 01 



Description 


Name 


NA 


Type 


Alias' 


X.25 lOCP 


$.IO0AB8 


OlAA 


USER 




3101-FPCAIOCP 


$.IO06F0 


OlAB 


USER 




Application program 


APROG 


OlAC 


USER 




Remote application in node 2 


APROG 


02AB 


USER 




Remote application in node 3 


APROG 


03AB 


USER 





Specify only for alias station 



SSPGOL Storage 



3 User/Msg Stations 
Alias Stations 



X 88 = 264 bytes 
X 40 = bytes 



2 Remote Stations x 32 = 64 bytes 
Volume Stations x 104 = bytes 






Figure 153. Example 13: Node 1 User/Message/ Alias/ Volume Configuration Worksheet 
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C3 



Device Configuration Worksheet 



System: Example 13: X.25 Connection between Series/ Is through an X.25 Network, Node 1 
Node Assignment: 01 



Description 


Name 


NA 


Type 


Device Type 


Buffer 
Size 


PDS' 


Polling 
CUDA 


Selection 
CUDAV 
HDCPY' 


Bit Rate' 


Auto 
Ans' 


3101 


TERM 1 A 


0160 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


4800 


Y 


3101 


TERM IB 


0161 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


4800 


Y 


Remote 3101 


TERM2A 


0260 


DEVICE 


3101F 


2500 




4040 


$SYSPRTR 


4800 


Y 


Remote 3101 


TERM2B 


0261 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


4800 


Y 


Remote 3101 


TERM3A 


0360 


DEVICE 


3101P 


2500 




4040 


SSYSPRTR 


4800 


Y 


Remote 3101 


TERM3B 


0361 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


4800 


Y 



' Specify only for printer device station 
^ Specify only for printer or 4978 device station 
' Specify only for 3101 or 3 101 F device station 
" Specify only for 3101 F device station 
For 7485's, bit rate must be 9600 and AUTO ANS=NO 






SSPOOL Storage 

2 3101F Devices x 160 = 320 bytes 

4978/Printer Devices x 264 = bytes 

3101 Devices x 304 = bytes 

4 Remote Stations x 32 = 128 bytes 



o 



Figure 154. Example 13: Node 1 Device Configuration Worksheet 
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Line / Terminal / Node Configuration Worksheet 

System: Example 13: X.25 Connection between Series/ Is through an X.25 Network, Node 1 
Node Assignment: 01 

Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


HDLC line 


LINEl 


0170 


LINE 


DTE 


2526 




128 


2 



Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address^ 


Line Name 


Volume 
Name* 


Polling 
CUDAV 

Portr 


Select 
CUDA' 


Remote node 2 


N0DE2 


0200 


NODE 


CF 












Remote node 3 


NODE2 


0300 


NODE 


CF 













' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
* Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 



o 



SSPGOL Storage 



1 HDLC Line 

Other Lines 

Terminals/Nodes 

2 Remote Stations 



X 112= 112 bytes 

X 264 = bytes 

X 88 = bytes 

X 32 = 64 bytes 



Figure 155. Example 13: Node 1 Line/Temiinal/Node Connguration Worksheet 



y 
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Circuit Configuration Worksheet 

System: Example 13: X.25 Connection between Series/ Is through an X.25 Network, Node 1 
Node Assignment: 01 

SVC Circuit Definition 



Description 


Name 


NA 


Type 


Circuit Type 


Line 


Usage 


Contact 


Call ID 


Packet Size 


Window 


Protocol ID' 


Facilities 


User Data' 


SVC circuit 


CIRC 1 A 


01C2 


CIRC 


SVC 


LINEl 


CF 


INIT 


2 






COOOOOOl 






SVC circuit 


CIRC IB 


01C3 


CIRC 


SVC 


LINEl 


CF 


INIT 


3 






COOOOOOl 







' Specify only for contact type INIT or WAIT 
^ Specify only for contact type INIT 

S$POOL Storage 

2 Circuits x 128 = 256 bytes 

Figure 156. Example 13: Node 1 Circuit Configuration Worlcdieet 



User/ Message /Alias /Volume Configuration Worksheet 

System: Example 13: X.25 Connection between Series/ Is through an X.25 Network, Node 2 
Node Assignment: 02 



Description 


Name 


NA 


Type 


Alias' 


X.25 lOCP 


$.IO0AB8 


02AA 


USER 




3101-FPCAIOCP 


$.IO06F0 


02AB 


USER 




Remote application program in node 1 


APROG 


OlAB 


USER 





Specify only for alias station 



SSPOOL Storage 



2 User/Msg Stations 

Alias Stations 

1 Remote Station 
Volume Stations 



x88= 176 bytes 

X 40 = bytes 

X 32 = 32 bytes 

X 104 = bytes 



Figure 157. Example 13: Node 2 User/Message/ Alias/Volume CMifiguration Worksheet 



Sample Configurations 399 



Device Configuration Worksheet 



System: Example 13: X.25 Connection between Series/ Is through an X.25 Network, Node 2 
Node Assignment: 02 



Description 


Name 


NA 


Type 


Device Type 


Buffer 
Size 


PDS' 


Polling 
CUDA 


Selection 
CUDAV 
HDCPV 


Bit Rate" 


Auto 
Ans" 


3101 


TERM2A 


0260 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


4800 


Y 


3101 


TERM2B 


0261 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


4800 


Y 



' Specify only for printer device station 
^ Specify only for printer or 4978 device station 
^ Specify only for 3101 or 3 101 F device station 
" Specify only for 3 101 F device station 
For 7485's, bit rate must be 9600 and AUTO ANS=NO 



SSPOOL Storage 



2 3 101 F Devices x 160 = 320 bytes 

4978/Printer Devices x 264 = bytes 

3 1 1 Devices x 304 = bytes 

Remote Stations x 32 = bytes 



Figure 158. Example 13: Node 2 Device Configuration Worksheet 
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Line I Terminal I Node Configuration Worksheet 

System: Example 13: X.25 Connection between Series/Is through an X.25 Network, Node 2 
Node Assignment: 02 

Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size" 


Window" 


HDLC line 


LINE2 


0270 


LINE 


DTE 


2526 




128 


2 



Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name* 


Polling 

CUDAV 

Portr 


Select 
CUDA' 


Remote node 1 


NODEl 


0100 


NODE 


CF 













' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
* Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 



S$POOL Storage 



1 HDLC Line 

Other Lines 

Terminals/Nodes 



X 112= 112 bytes 

X 264 = bytes 

X 88 = bytes 



1 Remote Station x 32 = 32 bytes 

Figure 159. Example 13: Node 2 Line/Temiinal/Node Configuration Worksheet 
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Circuit Configuration Worksheet 



System: Example 13: X.25 Connection between Series/ Is through an X.25 Network, Node 2 
Node Assignment: 02 

SVC Circuit Definition 



Description 


Name 


NA 


Type 


Circuit Type 


Line 


Usage 


Contact 


Call ID 


Pacliet Size 


Window 


Protocol ID' 


Facilities 


User Data' 


SVC circuit 


CIRC2A 


02C1 


CIRC 


SVC 


LINE2 


CF 


WAIT 









COOOOOOl 






SVC circuit 


CIRC2B 


02C3 


CIRC 


SVC 


LINE2 


CF 


WAIT 









C0000003 







Specify only for contact type INIT or WAIT 
Specify only for contact type INIT 



SSFOOL Storage 



2 Circuits x 128 = 256 bytes 

Figure 160. Example 13: Node 2 Circuit Configuration Worluheet 



User /Message /Alias /Volume Configuration Worksheet 

System: Example 13: X.25 Connection between Series/Is through an X.25 Network, Node 3 
Node Assignment: 03 



Description 


Name 


NA 


Type 


Alias' 


X.25 lOCP 


$.IO0AB8 


03AA 


USER 




3101-FPCAIOCP 


$.IO06F0 


03AB 


USER 




Remote application program in node 1 


APROG 


OlAB 


USER 





' Specify only for alias station 



SSPOOL Storage 



2 User/Msg Stations 

Alias Stations 

1 Remote Station 
Volume Stations 



X 88 =176 bytes 

X 40 = bytes 

X 32 = 32 bytes 

X 104 = bytes 



Figure 161. Example 13: Node 3 User/Message/Afias/Vohune Con^[uration Woriuiieet 
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Device Configuration Worksheet 

System: Example 13: X.25 Connection between Series/ Is through an X.25 Network, Node 3 
Node Assignment: 03 



Description 


Name 


NA 


Type 


Device Type 


Buffer 
Size 


PDS' 


Polling 
CUDA 


Selection 
CUDAV 
HDCPY' 


Bit Rate* 


Auto 
Ans' 


3101 


TERM3A 


0360 


DEVICE 


3101F 


2500 




4040 


SSYSFRTR 


4800 


Y 


3101 


TERM3A 


0361 


DEVICE 


3101F 


2500 




4040 


SSYSPRTR 


4800 


Y 



' Specify only for printer device station 
^ Specify only for printer or 4978 device station 
' Specify only for 3101 or 3101 F device station 
* Specify only for 31 OIF device station 
For 7485's, bit rate must be 9600 and AUTO ANS=NO 



SSPOOL Storage 



2 3 1 1 F Devices x 1 60 = 320 bytes 

4978/Printer Devices x 264 = bytes 

3 1 1 Devices x 304 = bytes 

Remote Stations x 32 = bytes 

Figure 162. Example 13: Node 3 Device Connguration Worksheet 
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Line /Terminal /Node Configuration Worksheet 

System: Example 13: X.25 Connection between Series/ Is through an X.25 Network, Node 3 
Node Assignment: 03 

Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size* 


Window' 


HDLC line 


LINE3 


0370 


LINE 


DTE 


2526 




128 


2 



Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name' 


Polling 

CUDAV 

Portr 


Select 
CUDA' 


Nodel 


NODEl 


0100 


NODE 


CF 










• 



' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
* Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 



SSPOOL Storage 



1 HDLC Line x 1 12 = 1 12 bytes 

Other Lines x 264 = bytes 

Terminals/Nodes x 88 = bytes 



1 Remote Station 



X 32 = 32 bytes 



Figure 163. Example 13: Node 3 Line/Terminal/Node Connguration Worksheet 



Circuit Configuration Worksheet 

System: Example 13: X.25 Connection between Series/ Is through an X.25 Network, Node 3 
Node Assignment: 03 

SVC Circuit Definition 



Description 


Name 


NA 


Type 


Circuit Type 


Line 


Usage 


Contact 


Call ID 


Packet Size 


Window 


Protocol ID' 


Facilities 


User Data' 


SVC circuit 


CIRC3B 


03C1 


CIRC 


SVC 


LINE3 


CF 


WAIT 


1 






COOOOOOl 







Specify only for contact type INIT or WAIT 
Specify only for contact type INIT 



SSPOOL Storage 



1 rjmiit 



X 128 = 128 bytes 



Figure 164. Example 13: Node 3 Circuit Configuration Worksheet 
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EDX Definitions 









Figure 165 shows the EDX definitions for node 1, 2, or 3. Just change LINEl to 
LINE2 for node 2 or to LINE3 for node 3. 



*** EXAMPLE 13 NODE 1, 2, or 3 
*** 

$EDXDEF CSECT 

SYSTEM MAXPROG= (10, 10,10,10) ,PARTB= (32, 32, 32,32) , X 

COMMON= ( CSXEND , CSXEND , CSXEND , CSXEND ) , X 

INITMOD= (CTZOII , CSXINIT) 

• 

DISK DEVICE=4962-3,ADDRESS=03, X 

VOLNAME= (EDX002 , EDX003 , ASMLIB) , TASK=YES , END=YES 

LINEl XHCDEV (71 , 70) , ADAPTER=2080 ,END=YES 
END 



Figure 165. Example 13: EDX Definitions 



o 
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Example 14: X.25 Connection between a Series/ 1 and DTEs 

Figure 166 on page 407 shows a configuration in which a Series/ 1 (Node 1) is 

connected to three X.25 DTEs (Node 2, Remote 1 and Remote 2). In this ^ w 

example, Node 2 is a Series/ Is running the Communications Facility; Remote 1 

and Remote 2 are any equipment that can function as X.25 DTEs. Between node 

1 and node 2, application programs APROG2A and APROG2B communicate with 

PROG3A and PROG3B, respectively. The application program in Remote 1 

communicates with application program PROG 1 A. The application program in 

Remote 2 communicates with application programs PROGIBI and PROG1B2. 



Configuration Description 



Look at the station definition worksheets for example 14. As in example 12, 
LINE2 is defined with subtype of DCE and LINE3 is defined with subt5rpe of 
DTE; this is required when the connection is not through an X.25 network. The 
circuit stations CIRC2A and CIRC3A are defined with subtype PVC and have the 
same logical channel ID of 001. The circuit stations CIRC2B and CIRC3B are 
also defined with subtype PVC and they have the same logical channel ID of 002. 
As in example 13, LINEl is defined with subtjrpe of DTE; this is required for 
connections through an X.25 network. 

Notice the following: 

. The circuit stations CIRC2A, CIRC3A, CIRC2B and CIRC3B are defined 
with usage of STD; this means that only data messages may flow between the 
circuit stations and the application programs. X.25 control messages sent to 
the circuit stations are rejected by $.IO0AB8, and $.IO0AB8 does not send 
any X.25 control messages to the application programs. 

• The circuit stations CIRCIA and CIRCIB are defined with usage of STD+; 
this means that X.25 control messages sent to the circuit stations are accepted 
and processed by $.IO0AB8. Also, if appropriate, $.IO0AB8 sends X.25 
control messages to the application programs. 

. The circuit stations CIRCIA, CIRCIB, CIRC2A, CIRC3A, CIRC2B and 
CIRC3B are linked to their respective appUcation programs using the direct 
link vector (DLV). Data messages read by $.100 AB8 from the HDLC line are 
sent to these application programs. 

• The circuit station CIRCIB is linked to PROGIBI using the alternate link 
vector. This means that all X.25 control messages associated with CIRCIB 
destined for the system is sent to PROGIBI. If the alternate link vector were 
not specified, all X.25 control messages would be sent to the station specified 
by the direct link vector, as in the case of CIRCIA and PROG 1 A. 

• The circuit station CIRCIA is defined with contact of INIT; this means that, as 
in example 13, $.IO0AB8 automatically sends a call request packet to the X.25 
network to initiate a virtual call. Because CIRCIA is defined with call ID 3, 
this call request packet specifies the X.25 network address of Remote 1. When 
the virtual call is established, the application program PROG 1 A communicates 
with the application in Remote 1. 

• The circuit station CIRC IB is defined with contact of USERINIT. This means 
that $.IO0AB8 waits for a call request control message to be sent to CIRCIB 
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Series/ 1, Node 


L 
































PROGIBI 


















4 










PR0G2A 




PR0G2B 




PROG 1 A 




PROG1B2 








i 

1 DLV 




A 

1 DLV 




A 

1 DLV 


,• 


A 

ALV 1 DLV 








CIRC2A 


CIRC2B 




CIRC 1 A 


CIRC IB 










LINE2 


$.IO0AB8 


LINEl 









DA -70 



DA = 72 



X.25 Network Address 
1234567811 



Series/ 1, Node 2 



DA = 70 








$.IO0AB8 


LINE3 








CIRC3A 


CIRC3B 






1 ] 
1 1 

1 DLV 1 DLV 

1 1 




PR0G3A 




PR0G3B 








X.25 Network Address 
1234567833 



X.25 Network Address 
1234567844 



Figure 166. Example 14: X.25 Connection between a Series/1 and DTEs 



o 



before sending the call request packet to the X.25 network. The called X.25 
network address on the call request packet is obtained from the call request 
control message. 

The routing of messages between the DTEs is similar to that described in two 
previous examples: messages between Node 1 and Node 2 are routed as described 
in "Example 12: X.25 Connection between Series/Is" on page 382, and 
messages between Node 1 and Remote 1 or Remote 2 are described in "Example 
13: X.25 Connection Between Series/Is through an X.25 Network" on page 392. 
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The difference between this example and the other X.25 examples is in the virtual 
call establishment and in the routing of messages within the Series/ Is. 



Establishing Virtual Calls 



Message Flow 



As in example 13, before messages can flow between Node 1 and Remote 1 or 
Remote 2, virtual calls between the DTEs must be estabUshed. Virtual call 
establishment between Node 1 and Remote 1 is similar to that described in 
example 13. As in example 13, when CIRCIA is started, $.IO0AB8 sends a call 
request packet to the X.25 network using information from CIRClA's station 
definition. 

The only difference between example 13 and this example is that, because 
CIRCIA is defined with usage of STD+, a call connected control message is sent 
by $.IO0AB8 to PROG 1 A when the call connected packet is received. If a clear 
indication packet is received, $.IO0AB8 sends the clear indication control message 
to PROGIA. 

The virtual call estabUshment between Node 1 and Remote 2 differs from that 
described for the virtual caU between Node 1 and Remote 1 because CIRCIB is 
defined with contact of USERINIT. When CIRCIB is started, $.IO0AB8 does not 
send a call request packet to the X.25 network, instead it waits for a call request 
control message to be sent to the circuit station. 

When a call request control message is sent to the circuit station, the lOCP 
retrieves it and sends a call request packet to the X.25 network. If the call request 
is accepted by the called DTE, $.IO0AB8 receives a call connected packet from the 
X.25 network. A call connected control message is sent to PROGIBI, because it 
is the circuit station's alternate Unk, If the call is cleared, and a clear indication 
packet is received, $.IO0AB8 sends the clear indication control message to 
PROGIBI. 

When the virtual calls are established, the flow of data messages for PROGIA and 
PROG1B2 from Remote 1 and Remote 2 is as described for PROG2A. 



When the stations have been defined, Unked as shown in Figure 166 on page 407, 
and started, a message from PROG3A is routed to PROG2A as follows. After 
PROG3A sends the message to CIRC3A, $.IO0AB8 retrieves it from CIRC3A's 
message queue, and transmits it over logical channel 001. $.IO0AB8 in Node 1 is 
notified that CIRC2A has received a message on its logical channel (channel 001), 
and reads the message. 

Up to this point, the message flow is similar to that in example 12. However, 
because CIRC2A's usage type is STD, the message is sent to the station specified 
by the direct Unk vector, PROG2A. When PROG2A receives it, the message no 
longer has its original routing information. The origin station is CIRC2A, not 
PROG3A. When PROG2A sends a response to the message, the response is 
routed over the same path — from CIRC2A to CIRC3A and then to its direct Unk, 
PROG3A. Similarly, a message sent by PROG3B is routed to PROG2B. 

Note that a separate path is required between each pair of appUcation programs. 
This is required because the original routing information is lost. If the messages 
flowed in only one direction, from Node 2 to Node 1, and, if only one appUcation 



\J ' 



o 
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o 






X.25 CaU ID Data Set 



O 



program in Node 1 were to receive all the messages, then all messages from the 
Node 2 application programs could be routed through one pair of circuit stations. 
But, if responses were routed back over the single path, only the direct link of the 
circuit station in Node 2 would receive the responses. 

In this example, node assignment is not required of the Series/ Is because there are 
no remote stations defined, that is, there is no station whose network address 
identifies it as being in the remote node. You may issue CP SET NODE 
commands to set node assignments, but you don't have to. If you do not, the node 
assigimient is 00, and the message dispatcher treats all stations as local stations, 
whatever their network address. 

In summary, to enable communication between a Series/ 1 and a DTE: 

• If the connection is through an X.25 packet switching network, define the line 
with subtype DTE. If the connection is not through an X.25 network, one Une 
station must be defined with subtype DCE and the other line station must be 
defined with subtype DTE. 

• If the application program sends and receives X.25 control messages, define 
the circuit station with usage of STD+, otherwise, define the circuit station 
with usage of STD. 

• If the application program initiates the virtual call establishment, define the 
circuit station with contact of USERINIT. Define the circuit station with 
contact of INIT if you want $.100 AB8 to initiate the virtual call. If the remote 
DTE initiates the virtual call establishment, define the circuit station with 
contact of WAIT. 

• Link the circuit stations to the appropriate application programs using the 
direct link vector. If a separate application program is to receive X.25 control 
messages, use the alternate Unk vector. 

• Define a separate path for each separate message destination. 



In this example only node 1 has SVC circuits with call IDs defined, so node 1 must 
have a $.SYSX25 data set containing the two call IDs and their associated X.25 
network addresses. Node 2 must have a $.SYSX25 data set with at least one 
record of /*. 



3 Remotel 1234567833 New York pubUshing 

4 Remote2 1234567844 London distributing 

/* 

Figure 167. Example 14: Node 1 $.SYSX25 Data Set 
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Figure 168. Example 14: Node 2 $.SYSX25 Data Set 



J 



Station Definitions 



Figure 169 through Figure 174 on page 415 show the station definitions for this 
example. 



User I Message I Alias I Volume Configuration Worksheet 

System: Example 14: X.25 Connection between Series/ Is and DTEs, Node I 
Node Assignment: 01 



Description 


Name 


NA 


Type 


Alias* 


X.25 lOCP 


$.IO0AB8 


OlAA 


USER 




Data and control message program 


PROG 1 A 


OlAB 


USER 




Data only program 


PR0G1B2 


OlAB 


USER 




Control message only program 


PROGIBI 


OlAC 


USER 




Data only program 


PR0G2A 


OlAE 


USER 




Data only program 


PROG2B 


OlAF 


USER 





\^ 



Specify only for alias station 



SSPOOL Storage 



6 User/Msg Stations 

Alias Stations 

Remote Stations 

Volume Stations 



X 88 = 528 bytes 

X 40 = bytes 

X 32 = bytes 

X 104 = bytes 



Figure 169. Example 14: Node 1 User/Message/ Alias/Volume Connguration Worksheet 



410 Communications Facility Design and Installation Guide 



Line I Terminal I Node Configuration Worksheet 



System: Example 14: X.25 Connection between Series/ Is and DTEs, Node 1 
Node Assignment: 01 

Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


HDLC line to network 


LINEl 


0172 


LINE 


DTE 


128 




128 


2 


HDLC line to node 2 


LINE2 


0170 


LINE 


DCE 


128 




128 


2 



Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name* 


Polling 

CUDAV 

Portr 


Select 
CUDA' 











































' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
^ Specify only for 3271, 3277, or 3286 terminal station 
" Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 



S$POOL Storage 



2 HDLC Lines 

Other Lines 

Terminals/Nodes 

Remote Stations 



X 112 = 224 bytes 

X 264 = bytes 

X 88 = bytes 

X 32 = bytes 



Figure 170. Example 14: Node 1 Line/Terminal/Node Configuration Worksheet 
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Circuit Configuration Worksheet 



System: Example 14: X.25 Connection between Series/ Is and DTEs, Node 1 
Node Assignment: 01 

PyC Circuit Definition 



Description 


Name 


NA 


Type 


Circuit Type 


Line 


Usage 


LCI 


PVC circuit 


CIRC2A 


OlCl 


CIRC 


PVC 


LINE2 


STD 


001 


PVC circuit 


CIRC2B 


01C2 


CIRC 


PVC 


LINE2 


STD 


002 



SVC Circuit DeFinition 



Description 


Name 


NA 


Type 


Circuit Type 


Line 


Usage 


Contact 


Call ID 


Packet Size 


Window 


Protocol ID' 


Facilities 


User Data' 


SVC circuit 


CIRCIA 


01C3 


CIRC 


SVC 


LINEl 


STD+ 


INIT 


3 






C0001234 




PASSWORD=CFP 


SVC circuit 


CIRCIB 


01C4 


CIRC 


SVC 


LINEl 


STD+ 


USERINIT 


4 













Specify only for contact type INIT or WAIT 
Specify only for contact type INIT 



4 Circuits 



SSPOOL Storage 

X 128 = 512 bytes 



Figure 171. Example 14: Node 1 Circuit Configuration Worksheet 
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User /Message I Alias I Volume Configuration Worksheet 



System: Example 14: X.25 Connection between Series/ Is and DTEs, Node 2 
Node Assignment: 02 



Description 


Name 


NA 


Type 


Alias' 


X.25 lOCP 


$.IO0AB8 


02AA 


USER 




Data only application program 


PROG3A 


02AB 


USER 




Data only application program 


PROG3B 


02BC 


USER 





Specify only for alias station 



S$POOL Storage 



3 User/Msg Stations 

Alias Stations 

Remote Stations 

Volume Stations 



X 88 = 264 bytes 

X 40 = bytes 

X 32 = bytes 

X 104 = bytes 



Figure 172. Example 14: Node 2 User/Message/ Alias/Volume Configuration Worksheet 



\^ 
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Line /Terminal /Node Configuration Worksheet 



System: Example 14: X.25 Connection between Series/ Is and DTEs, Node 2 
Node Assignment: 02 












Line Definitions 










Description 


Name 


NA . 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


HDLC line 


L1NE3 


0270 


LINE 


DTE 


128 




128 


2 



Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name' 


Polling 

CUDAV 

Port#^ 


Select 
CUDA' 











































' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
- Specify only for Local Communications Controller node station 
^ Specify only for 3271, 3277, or 3286 terminal station 
" Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 



\.y 



SSPOOL Storage 



1 HDLC Line 

Other Lines 

Terminals/Nodes 

Remote Stations 



X 112= 112 bytes 

X 264 = bytes 

X 88 = bytes 

X 32 = bytes 



F^ure 173. Example 14: Node 2 Line/Tenninal/Node Configuration Worksheet 



^W*^^ 
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Circuit Configuration Worksheet 



System: Example 14: X.25 Connection between Series/ Is and DTEs, Node 2 
Node Assignment: 02 

PVC Circuit Definition 



Description 


Name 


NA 


Type 


Circuit Type 


Line 


Usage 


LCI 


PVCl 


CIRC3A 


02C1 


CIRC 


PVC 


LINE3 


STD 


001 


PVC 2 


CIRC3B 


02C2 


CIRC 


PVC 


LINE3 


STD 


002 



SSPOOL Storage 

2 Circuits x 128 = 256 bytes 

Figure 174. Example 14: Node 2 Circuit Conflgiu-ation Worksheet 



EDX Definitions 






Figure 175 shows the EDX definitions for node 1 and Figure 176 on page 416 
shows the EDX definitions for node 2. 



*** EXAMPLE 14, NODE 1 

SYSTEM MAXPROG=(10, 10, 10, 10) , PARTS= (32 , 32 , 32 , 32) , 
COMMON= ( CSXEND , CSXEND , CSXEND , CSXEND) , 
INITMOD= (CTZOII , CSXINIT) 



DISK DEVICE=4962-3,ADDRESS=03, 

VOLNAME= (EDX002 , EDX003 , ASMLIB) , TASK=YES , END=YES 



LINE1 XHCDEV (73 , 72) , ADAPTER=2080 ,END=NO 
LINE2 XHCDEV (71 , 70) , ADAPTER=2080 ,END=YES 



Figure 175. Example 14: Node 1 EDX Definitions 
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*** EXAMPLE 14, NODE 2 

SYSTEM MAXPROG=(10, 10, 10, 10) ,PARTS=(32,32,32,32) , X ,^^1 

COMMON= ( CSXEND , CSXEND , CSXEND , CSXEND ) , X V J^ 

INITMOD= (CTZOII , CSXINIT) 

DISK DEVICE=4962-3,ADDRESS=03, X 

VOLNAME=(EDX002,EDX003,ASMLIB) , TASK=YES , END=YES 

LINE3 XHCDEV (71 , 70) , ADAPTER=2080, END=YES 
*** 

END 
Figure 176. Example 14: Node 2 EDX Definitions 






c 
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Example 15: LAN with Series/1-PC Connect Attachment and EDX 
Secondary SNAl Connection 



Message Flow 






Figure 177 on page 419 shows a configuration in which a Series/ 1 is connected to 
a host computer by an EDX Secondary SNAl connection. The Series/ 1 appears to 
the host as an SNA physical unit, two SNA type 2 logical units (terminals), and one 
SNA type 1 logical unit (printer). The real devices are PCs and PC printers 
connected by a local area network (LAN). One of the PCs in the LAN is attached 
to the Series/ 1 by a Series/ 1 -PC Connect Attachment, and is called the gateway 
PC. 

Using this example a PC user can: 

• Pass through to a host as a 3278 

• Initiate a host-to-PC file transfer 

• Define a PC printer as a 3286 or 3287 printer. 



To achieve the flow of messages between the host and the PCs, each remote 
station and its associated SNA logical unit stations are linked to each other. The 
remote stations (for example, PC 12) are created because they are defined as 
remote message stations. The PC user must log on to one of these remote stations 
using the IBM PC Network SNA 3270 Emulation Program. 

Once the PC user has logged on to one of these remote stations and the associated 

SNA logical units have started, communication between the host and the PC can /<""> 

start. When the PC user presses an interrupt key, the IBM PC Network SNA 3270 \^ 

Emulation Program routes that message over the LAN to the gateway PC. The 

IBM PC Network SNA 3270 Emulation Program delivers the message to the 

Series/1-PC Connect Program (5719-CNl) running in the gateway PC. The 

Series/ 1 -PC Connect Program then places a Personal Computer header on the 

message. This header contains information about the origin and destination 

stations. The header also serves as a function identifier which indicates the type of 

function to be performed. The Series/ 1 -PC Connect Program transmits the 

message including the message header to the Series/ 1 through the Series/ 1 -PC 

Connect Attachment. 

On the Series/ 1, the PC Connect lOCP, $.IO0AA8, receives the message and 
examines the header to determine which function has been requested. In this case, 
host communication has been requested. 

The PC Connect lOCP converts the Personal Computer header to a 
Communications Facility header and uses the origin station's direct link as the 
destination station. 

The lOCP handles segmented messages. When it receives the first message in a 
chain of segmented messages, it obtains a 2K mapped or unmapped storage block. 
The lOCP stores all the messages from the same origin station in that block until 
the last message in the chain is received. After receiving and storing the last 
message in the chain or the only message in a chain, the lOCP sends the message 
to the origin station's direct link vector. 
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g*^,^ 



Host 



fi 



$.I014E8 



LCFS02 



SDLC 



DA = OA 



P028CFS 



LCFS03 



LCFS04 



PCI 2 I 



— I , |_1 , 

PC13 I I PRU I 
I L I 



$.IO0AA8 



PCNODECl 



PCCLINE 



DA = BO 



LPTl 



PC Node CI 



PCll 



PCI 2 



PC13 



Series/ 1 
Node C2 



Figure 177. Example 15: LAN with Series/ 1 -PC Connect Attachment and SNA Connection 



The SNA lOCP, $.I014E8, receives data from the host and forwards according to 
the local address specified for the SNA logical unit stations. For example, data for 
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logical unit 2 is intended for station LCFS02, so it is sent to that station's link, 
PCI 2. 

$.100 AA8 receives the message from the PC node station's queue. It converts the 
Communications Facility message header to a Personal Computer message header. 
Then it transmits the message to the gateway PC through the Series/ 1 -PC Connect 
Attachment. 



/fT\, 



Station Definitions 



Message routing for file transfer and printer support functions is the same as 
described for terminals. 



Figure 1 78 through Figure 180 on page 422 show the station definitions for this 
example. 



User /Message I Alias /Volume Configuration Worksheet 

System: Example 15: LAN with Series/ 1 -PC Connect Attachment and SNA Connection 
Node Assignment: C2 



Description 


Name 


NA 


Type 


Alias' 


SNA lOCP 


$.I014E8 


C2AA 


USER 




PC Connect lOCP 


$.100 AA8 


C2AB 


USER 




Remote station for PC 12 


PC12 


CIAl 


MESSAGE 




Remote station for PC 13 


PCI 3 


C1A2 


MESSAGE 




Remote station for PRl 1 


PRll 


CIA3 


MESSAGE 





' Specify only for alias station 



SSPOOL Storage 



2 User/Msg Stations 
Alias Stations 

3 Remote Stations 
Volume Stations 



x88 = 176 bytes 

X 40 = bytes 

X 32 = 96 bytes 

X 104 = bytes 



Figure 178. Example 15: User/Message/Alias/Volume Configuration Worksheet 
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Line I Terminal / Node Configuration Worksheet 

System: Example 15: LAN with Series/ 1 -PC Connect Attachment and SNA Connection 
Node Assignment: C2 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


Series/ 1 -PC Connect 
Attachment 


PCCLINE 


C2C0 


LINE 


PCC 


4096 


BO 







Terminal and Node Definitions 






Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name* 


Polling 

CUDAV 

Portr 


Select 
CUDA» 


PC Node CI 


PCNODECl 


ClOO 


NODE 


PC 




PCCLINE 









Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 

Specify only for Local Communications Controller node station 

Specify only for 3271, 3277, or 3286 terminal station 

Specify only for port terminal station 

Specify only for DCE or DTE line station 

Specify only for PC node station 



SSPOOL Storage 



.HDLC Lines 



1 Other Line 
1 Terminal/Node 
Remote Stations 



X 112 



bytes 



X 264 = 264 bytes 

X 88 = 88 bytes 

X 32 = bytes 






Figure 179. Example 15: Line/Terminal/Node Configuration Worksheet 
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SNA Configuration Worksheet 

System: Example 15: LAN with Series/ 1 -PC Connect Attachment and SNA Connection 
Node Assignment: C2 

PU Definition 






Description 


Name 


NA 


Type 


Buffer Size 


PU 


Host Application Host Mode 


SNA physical unit 


P028CFS 


C20A 


PU 


2500 




#1:TS0 LU2256 


#2: IMS STD32741 


#3: CICS STD32743 



LU Definitions 



Description 


Name 


NA 


Type 


Term 
Type 


PU Name 


Local 
Address 


Logon ID 


User Data 


Emulated terminal 


LCFS02 


C2E2 


LU 


3278 


P028CFS 


2 


1 




Emulated terminal 


LCFS03 


C2E3 


LU 


3278 


P028CFS 


3 






Emulated printer 


LCFS04 


C2E4 


LU 


3286 


P028CFS 


4 


3 





Valid only for EDX Secondary SNA2 



1 Physical Unit 
3 Logical Units 
Remote Stations 



SSPOOL Storage 

X 128 = 128 bytes 
X 280 = 840 bytes 
X 32 = bytes 






Figure 180. Example 15: SNA Configuration Worksheet 



Notice the terminal type of the SNA logical units in Figure 180. It must 
correspond to the session that has been estabUshed by the IBM PC Network SNA 
3270 Emulation Program and the associated remote station. For example, if PC 12 
is used to log on to a terminal session, then LCFS02 should be a logical unit type 2. 

Notice the logon information in Figure 180. There are three host applications 
specified: #1 is for TSO/terminal communication; #2 is for IMS/printer 
communication; and #3 is for CICS/printer communication. An operator at the 
PC which is logged on to station PC 12 is automatically connected to TSO when the 
LU station is started and the log on process is complete. 

An operator at the PC logged on to PC 13 station, is presented with a logon prompt 
screen when the LU station is started and the IBM PC Network SNA 3270 
Emulation Program log on procedure is completed. See the "Series/ 1-to-Host 
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SNA lOCP, $.I014E8" on page 169 for an example of the log on screen. The 
screen shows the applications specified in the SNA physical unit. The terminal user 
can select option 1 to log on to TSO or option 4 to log on to any other SNA 
application defined in the host. 

The printer is automatically connected to CICS when the logical unit is started. 



Station Links 



The SNA LU stations must be directly linked to the remote stations that represent 
the PCs and the printer. The remote stations must also be directly linked to the 
SNA LU stations. 



I Station Mode of Operation 



The mode of operation for LU stations must be PC. Before starting the LU 
stations, use the CP F MODE command to change the mode of command to PC 
for each of the LU stations that are directly linked to the remote stations that 
represent the PCs. It is recommended that you also set UBRETRY mode for these 
LU stations. If you specify UBSTOP and an auto-logon session is unbound, the 
LU station must be started again before the user can log on to the PC again. 



EDX Definitions 






Figure 181 shows the EDX definitions for example 15. You may not want to map 
the common area in to all partitions as shown in the example. For example, the 
partition in which EDX Secondary SNAl runs does not have to be mapped unless 
Communications Facility programs also run in that partition. 



*** EXAMPLE 15 

$EDXDEF CSECT 

SYSTEM STORAGE=256,MAXPROG=(10,10,10,10) ,PARTS=(32,32,32,32) , X 
COMMON= ( CSXEND , CSXEND , CSXEND , CSXEND ) , X 

INITMOD=(CSPCCIPL,CSXINIT) 



SNALINE 



PCC 

PCC 

PCC 

EXIODEV 

END 



ADDRESS=BO 

ADDRESS=B1 

ADDRESS=B2 , END=YES 

ADDRESS=OA , RSB=4 , MAXDCB=6 , END=YES 



Figure 181. Example 15: EDX Definitions 
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PC Installation and Setup 



This section describes tlie installation and setup procedures for the three PCs and 
the printer in this example. The gateway PC should be installed and set up before 
the other PCs in the network. 



,/f^~V, 



Gateway PC 



See the Series/ 1 -PC Connect for the Event Driven Executive Communications 
Facility for instructions on instalUng the Series/ 1 -PC Connect Attachment on a PC 
for a 3270 communications gateway. After completing this procedure, you must 
use the Series/ 1 -PC Connect customization program, SIPCCUST.BAS, to specify 
the following: 

Option 7: Enter AA as the gateway PC's LAN name. 

Option 5: Enter PC12, PC13, and PRl 1 in the gateway PC's 3270 names Ust. 
Option 10: Use this option to customize certain technical characteristics 
of the PC Connect. 



In the new menu presented for option 10, do the following: 

Option 4: Enter N to disable inter-LAN message support. 

Option 5: Enter N to disable interprogram support. 

Option 6: Enter N to disable disk emulation support. 

Option 7: Enter Y to enable 3270 support. 

You have customized the gateway PC as a 3270 communications gateway PC. 

After completing the instructions presented above, you should start the 
Communications Facility stations and IPL the gateway PC. Now, you can load the 
IBM PC Network SNA 3270 Emulation Program, PSCPG. 

Use the communications profile option of the PSCPG to specify the following 
parameters for the gateway PC: 






Gateway with network station 

Enable 3270-PC file transfer 

Printer device name — LPTl 

Gateway session name (required for printer support) — GATEWAYOl 

Maximum number of sessions — 8 

Names of each network station: 

- GATEWAYOl 

- USERl 

- USER2 



After storing these changes, choose the communicate option of the PSCPG 
program to establish communication. 
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User PC 



On each user PC, PC12 and PC13, load the PSCPG program. Use the 
communications profile option of PSCPG to specify the following parameters for 
the user PCs: 

• User PC network station 

. Enable 3270-PC file transfer 

• Printer device name — LPTl 

• Names of each network station: 

- USERlforPC12 

- USER2forPC13. 

After storing these changes, choose the communicate option of the PSCPG 
program to establish communication. 

Enter PRINTON PR 11 3 LUl on PCI 2. 3 corresponds to the session number 
identified for the printer. A session start message should be received. Now, enter 
LOGON PCI 2 on PC 12. A session start message should be received again. 

Enter LOGON PC 13 on PCI 3 to start a session. A session start message should 
be received. 

There should be a logon prompt screen on the user PC, PC13. 



EDX Secondary SNAl and Host System Definitions 



jf^ 



This configuration must also be defined to the EDX Secondary SNAl, to the host 
system access method (VTAM in this example), and to the host subsystem (CICS 
in this example). The sample definitions are not compatible with every SNA 
environment; you can use them as models to develop your customized definitions. 
Parameters have not been optimized, and there may be instances of values that 
restrict usage or degrade performance. 

The examples show definitions of SNA 3274-SDLC and associated terminals to the 
network. No special parameters are needed in the network for the 
Communications Facility; you can use standard 3274 definitions. When you define 
your configuration, refer to the 3274 and SNA publications listed in "About This 
Book" on page iii and to the publications for your host system and subsystem. 
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Several parameters in the various definitions must agree with each other. The 

corresponding values defined in the figures in this section, the values defined to 

EDX in the EXIODEV statement (shown in the EDX definitions), and the values ,^^ 

defined for Communications Facility SNA stations (shown on the SNA ^ ) 

configuration worksheet) are as follows: "^--^^ 

D EDX-SNA SNAPU ADDRESS and EXIODEV ADDRESS. (This 

address has also been used as the PU station network address, which is 
recommended but not required.) 

Q EDX-SNA SNAPU ENCODE and NCP/VTAM NRZI. 

Q EDX-SNA SNAPU BUFSIZ must be greater than or equal to 

NCP/VTAM MAXDATA. 

Q EDX-SNA SNAPU DCBNO, NCP/VTAM MAXOUT, and EXIODEV 

MAXDCB. 

B EDX-SNA SNALU number, NCP/VTAM LOCADDR, and LU station 

local address. 

B NCP VTAM MODETAB and VTAM mode table name. 

Q NCP VTAM PU ADDR and secondary station address strapped on 

SDLC attachment card. 

Q NCP/VTAM LU name and CICS NETNAME. (This name has also 

been used as the LU station name, and the NCP/VTAM PU name has 
been used as the PU station name, which is recommended but not /^\ 

required.) V^ y 

Q VTAM LOGMODE name and Communications Facility SNA 

application mode (HOST MODE). 

VTAM APPL name and Communications Facility SNA appUcation name 
(HOST APPL). 



EDX Secondary SNAl Definitions 



Figure 182 on page 427 shows the EDX Secondary SNAl definitions for example 
15, The definitions support four logical units using 256-byte buffers. Only two 
buffers per logical unit are allocated; you may want more for best performance. 
See the EDX Secondary SNAl Guide for information about how buffers and related 
parameters affect performance. 



o 
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NET1 CSECT , 

SNAPU RETRY=3, 

ADDRESS=OA, 

CNCTYPE=PP , 
NORING=NO , 
RATE=FULL, 
ENCODE=NRZ , 

PAD=NO , 
TODTR=0 , 
TODSR=0, 
TOCTS=0, 
TOHLA=0 , 
THRESH=4 , 
BUFSIZ=256, 

BUFN0=4 , 
DCBN0=7 , 



DEFINE THE NETWORK 

NUMBER OF I/O RETRIES X 

DEVICE ADDRESS X 

CONNECTION TYPE X 

INCLUDE RING SUPPORT X 

MODEM SPEED X 

MODEM ENCODING X 

SEND PAD CHAR ON INITIAL XMISSION X 

DATA-TERMINAL-READY TIMEOUT X 

DATA-SET-READY TIMEOUT X 

CLEAR-TO-SEND TIMEOUT X 

HOLD-LINE-ACTIVE TIMEOUT X 

MINIMUM BUFFS TO SEND RECEIVE-READY X 

SIZE OF LARGEST USER MESSAGE X 

NUMBER OF BUFFERS AT ACTIVATION X 

MAXIMUM FRAMES TO SEND OR RECEIVE X 



STAXID=SOOOOO ID TO SEND IN RESPONSE TO XID CMD 



SNALU LU=1 , 



LOGICAL UNIT NUMBER 



X 



SENDBUF=1 , 
RECVBUF=1 , 
CTE=1 , 
END=NO 

SNALU LU=2, 

SENDBUF=1 , 
RECVBUF=1 , 
CTE=1 , 
END=NO 

SNALU LU=3, 

SENDBUF=1 , 
RECVBUF= 1 , 
CTE=1 , 
END=NO 



NUMBER OF SEND BUFFERS FOR LU X 
NUMBER OF RECEIVE BUFFERS FOR LU X 
NUMBER OF CORRELATION TABLE ENTRIES X 



LOGICAL UNIT NUMBER X 

NUMBER OF SEND BUFFERS FOR LU X 
NUMBER OF RECEIVE BUFFERS FOR LU X 
NUMBER OF CORRELATION TABLE ENTRIES X 



LOGICAL UNIT NUMBER X 

NUMBER OF SEND BUFFERS FOR LU X 
NUMBER OF RECEIVE BUFFERS FOR LU X 
NUMBER OF CORRELATION TABLE ENTRIES X 



SNALU LU=4, 

SENDBUF=1 , 
RECVBUF=1 , 
CTE=1 , 
END=YES 

END 



LOGICAL UNIT NUMBER X 

NUMBER OF SEND BUFFERS FOR LU X 
NUMBER OF RECEIVE BUFFERS FOR LU X 
NUMBER OF CORRELATION TABLE ENTRIES X 
LAST LOGICAL UNIT TO GENERATE 



Figure 182. Example 15: EDX Secondary SNAl Definitions 



Host System Definitions 



Figure 183 on page 428 shows the definitions of physical and logical units to the 
network control program (NCP) and VTAM. They are defined as a PU type 2 
(cluster controller) and its associated LUs. No information about LU type is 
specified to the NCP. VTAM unformatted session services table (USSTAB) 
specifications are not included, because the Communications Facility can't use this 
VTAM service. The SNA lOCP has its own log on technique that replaces the 
USS screen and facilities. If USSTAB is specified for your system, the 
Communications Facility won't use it, but it shouldn't cause any problem. 
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GCFSDLC 


GROUP 


LNCTL=SDLC, 


SDLC LINE 


X 








POLLED=YES , 


3274 ALWAYS POLLED 


X 








NRZI=NO 


NRZI 




B 


* 

LINE028 


LINE 


ADDRESS=028, 


LINE ADDRESS IN 3705 


X 








DISCNT=NO, 


VTAM ONLY OPERAND 


X 








MODETAB=CFTBL, 


VTAM MODE TABLE 


X 


U 






DLOGMOD=LU2256, 


DEF LOGON MODE FROM MODETAB 


X 








SPEED=4800, 


LINE SPEED (SEE NCP DOCS) 


X 








RETRIES=(5,1 ,20) , 


RECOVERY ATTEMPTS S PAUSE 


X 








PACING=0 , 


PACING NOT NORMALLY USED 


X 








VPACING=0 , 


FOR DISPLAYS OR PRINTERS 


X 




^ 




ISTATUS=ACTIVE 


LINE COMES UP WITH NCP 






:|c 


SERVICE ORDER=(P028CFS) 


ONLY 1 STATION HERE 






P028CFS 


PU 


ADDR=01, 


MATCH SDLC CARD STRAPPING 


X 


B 






PUTYPE=2 , 


CLUSTER CONTROLLER 


X 








MAXDATA=256, 


SEGMENT SIZE 


X 


B 



.Y"^ 



PASSLIM=7, 
MAX0UT=6 



MAX CONSEC RU'S TO THIS PU 
MAX FRAMES BEFORE RESPONSE 



LCFS01 LU L0CADDR=1 Q Q 



LCFS02 LU 
LCFS03 LU 
LCFS04 LU 



L0CADDR=2 
L0CADDR=3 
L0CADDR=4 



Figure 183. Example 15: Definitions to NCP and VTAM 



Figure 1 84 on page 429 shows the definition of a VTAM mode table. The SNA 
application modes used with the Communications Facility correspond to SNA 
session parameters that are defined in SNA bind commands. A given mode name 
refers to an image of a specific bind command stored on the host. You must define 
all modes used with the Communications Facility. The sample mode table includes 
entries for LU types 1,2, and 3, as suggested in the 3274 Guide. The restriction 
the Communications Facility places on mode values is that only 24 x 80 screen 
size is supported for both default and alternate screens. For subtype 3286 and 
3287 LU3 stations, and for subtype 3278 and 3279 LU2 devices, the 
Communications Facility will accept the bind, and assume the real device can 
handle the alternate size. See the 32 74 Guide for details of valid bind images. 

Figure 185 on page 429 shows the definition of application programs to VTAM. 
You must define all SNA application names used with the Communications 
Facility. 
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CFTBL 



MODETAB 






* STANDARD 3274 LUI FROM 3274 PUBLICATION 
STD32741 MODEENT LOGMODE=STD32741 , X 

FMPROF=X'03' , X 

TSPROF=X'03' , X 

PRIPR0T=X'B1 ' , X 

SECPROT=X ' 90 ' , X 

COMPROT=X'3080' , X 

RUSIZES=X'8587' , X 
PSERVIC=X' 01 0000000000000000000000' 

* STANDARD 3274 LU3 FROM 3274 PUBLICATION 
STD32743 MODEENT LOGMODE=STD32743 , X 

FMPROF=X'03' , X 

TSPROF=X'03' , X 

PRIPR0T=X'B1 • , X 

SECPROT=X'90' , X 

COMPROT=X'3080' , X 

RUSIZES=X'8587' , X 
PSERVIC=X' 030000000000000000000000' 

* LU2 WITH 256-BYTE RU SIZE 

LU2256 MODEENT LOGMODE=LU2256 , X 

FMPROF=X'03' , X 

TSPROF=X'03' , X 

PRIPR0T=X'B1 ' , X 

SECPROT=X'90' , X 

COMPROT=X'3080' , X 

RUSIZES=X'8585' , X 
PSERVIC=X' 020000000000000000000200' 

MODEEND 

END 

Figure 184. Example 15: VTAM Mode Table 



IMS 
CICS 



APPL AUTH= ( ACQ , PAS S ) 
APPL AUTH= ( ACQ , VPACE ) 



* 

TSO 

TSO0001 

TSO0002 

TSO0003 

TSO0004 

TSO0005 

TSO0006 

TSO0007 

TSO0008 

TSO0009 

TSO0010 



APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 
APPL 



AUTH= 
AUTH= 
AUTH= 
AUTH= 
AUTH= 
AUTH= 
AUTH= 
AUTH= 
AUTH= 
AUTH= 
AUTH= 



(NOBLOCK, 
(NOBLOCK, 
(NOBLOCK, 
(NOBLOCK, 
(NOBLOCK, 
(NOBLOCK, 
(NOBLOCK, 
(NOBLOCK, 
(NOBLOCK, 
(NOBLOCK, 
(NOBLOCK, 



PASS 
PASS 
PASS 
PASS 
PASS 
PASS 
PASS 
PASS 
PASS 
PASS 
PASS 



,NOPO, 
,NOPO, 
,NOPO, 
,NOPO, 
,NOPO, 
, NOPO , 
,NOPO, 
, NOPO , 
,NOPO, 
, NOPO , 
,NOPO, 



TSO,NVPACE) 
TSO,NVPACE) 
TSO,NVPACE) 
TSO,NVPACE) 
TSO,NVPACE) 
TSO,NVPACE) 
TSO,NVPACE) 
TSO,NVPACE) 
TSO,NVPACE) 
TSO,NVPACE) 
TSO,NVPACE) 



,EAS=10 

,EAS=1 

,EAS=1 

,EAS=1 

,EAS=1 

,EAS=1 

,EAS=1 

,EAS=1 

,EAS=1 

,EAS=1 

,EAS=1 



Figure 185. Example 15: Definition of Applications to VTAM 



Figure 186 on page 430 shows a CICS terminal control table with entries for the 
three type 2 logical units and the type 3 logical unit used in this sample 
configuration. 
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LC01 DFHTCT TYPE=TERMINAL , 
TRMTYPE=LUTYPE2 , 
TRMM0DL=2, 
TRMIDNT=LCO 1 , 
BUFFER=0 , 
RUSIZE=256, 
TIOAL= (256, 2048) , 
NETNAME=LCFS01 , 



TERMINAL 






LC02 



* 
LC03 



CHNASSY=YES , 
BRACKET=YES , 
TRMSTAT=(TRANSCEIVE) , 
ACCMETH=VTAM, 
GMMSG=YES , 
RELREQ=(YES,YES) 

DFHTCT TYPE=TERMINAL, 

TRMTYPE=LUTYPE2 , TERMINAL 

TRMM0DL=2 , 

TRMIDNT=LC02, 

BUFFER=0 , 

RUSIZE=256, 

TIOAL= (256, 2048) , 

NETNAME=LCFS02 , 

CHNASSY=YES , 

BRACKET=YES , 

TRMSTAT= (TRANSCEIVE) , 

ACCMETH=VTAM, 

GMMSG=YES, 

RELREQ=(YES,YES) 



DFHTCT TYPE=TERMINAL, 

TRMTYPE=LUTYPE3 , PRINTER 

TRMM0DL=2 , 

TRMIDNT=LC03, 

BUFFER=0 , 

NETNAME=LCFS03, 

TRMSTAT= (TRANSCEIVE) , 

ACCMETH=VTAM 



~X 



\.J 



Figure 186. Example 15: CICS Terminal Control Table 



o 
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Example 16: PC Connect with Inter-LAN Services 



Figure 187 shows a configuration in which two Series/ Is are connected to a Local /f"> 

Communications Controller. A PC LAN is also connected to each Series/ 1 %.^P^ 

through a Series/ 1 -PC Connect Attachment. 





I 


5262 








)A = 24 






Series/ 1 
Node C2 








LPTl 


$.100674 


1 
1 






DA = BO 


$.IO0AA8 




1 
1 
1 

1 -, 1 

PCN0DEC4 1 SlAP 




PCll 


PCCDEV 


PCNODECl 
















PC Node CI 


k 
1 
1 
1 

1 ' 

1 

1 

1 

1 












PC12 




PC13 




1 

Y 












N0DEC3 






PCVOLl 


$.I01CC8 


LCCDEV 


S.IOOABO 




1 

' \ 

k^ PCVOLl / 


D 
/ 


A = 50 


Ring Address = 2F 












DA = BO 






DA = 50 


Ring Address = 


IF 


Series/ 1 
Node C3 










S.IOOABO 


LCCDEV 







SlAP 


DA = 24 








NODEC2 








1 








$.IO0AA8 


PCNODECl 1 
1 






PC21 


PCCDEV 


PCN0DEC4 


LPT2 


4975 










PC Node C4 










i 
1 
1 


$.100674 






























1 

1 
1 




PC22 


PC23 






PCVOLD 


$.I01CC8 





f^ .] 

\^ PCVOLD^/ 



Figure 187. Example 16: PC Connect with Inter-LAN Services 



\^ 
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Using this configuration, a PC user can: 

Use Series/ 1 printers as LAN-shared printers 

Use Series/ 1 data sets as LAN-shared disk devices 

Issue inter-LAN messages 

Write a PC program to communicate with a PC program on another LAN 

Write a PC program to communicate with a Series/ 1 program 

Write a PC program to issue user error logs. 

This example does not include communication with a host system. You could 
attach another PC, running the IBM PC Network SNA 3270 Emulation Program, 
to the Series/ 1 through a Series/ 1 -PC Connect Attachment to provide 
communication with the host. 



EDX Definitions 



Figure 188 shows the EDX definitions for example 16. In this example partition 
numbers 1 and 3 are not mapped with COMMON. 






*** EXAMPLE 16 
*«* 

$EDXDEF CSECT 

SYSTEM STORAGE=512,MAXPROG=(10,10,10,10,10,10,10,10) , X 
PARTS=(32,32,32,32,32,32,32,32) , COMMON= ( CSXEND , X 
CSXEND , , CSXEND , CSXEND , , CSXEND , CSXEND ) , X 

INITMOD=(CSPCCIPL,CSXINIT) 



$SYSPRTR TERMINAL DEVICE=5262 , ADDRESS=24 ,END=YES 



LCC 


ADDRESS=50 


LCC 


ADDRESS=51 


LCC 


ADDRESS=52 


PCC 


ADDRESS=BO 


PCC 


ADDRESS=B1 


PCC 


ADDRESS=B2 , END=YES 


END 





Figure 188. Example 16: EDX Definitions 
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Station Definitions 



Figure 189 through Figure 194 on page 439 show the station definitions for the 
two Series/ 1 nodes in this configuration. 






User /Message /Alias /Volume Configuration Worksheet 



System: Example 16: PC Connect with Inter-LAN Services 
Node Assignment: C2 



Description 


Name 


NA 


Type 


AUas' 


Printer lOCP 


$.100674 


C2AA 


USER 




LCC lOCP 


S.IOOABO 


C2AB 


USER 




PC Connect disk-server lOCP 


$.101 CCS 


C2AC 


USER 




PC Connect lOCP 


$.IO0AA8 


C2AD 


USER 




Application Remote Station 


SlAP 


C3A0 


USER 




PC LAN CI Volume Station 


PC VOL 1 


C2AE 


VOLUME 





Specify only for alias station 



4 User/Msg Stations 

Alias Stations 

1 Remote Station 
1 Volume Station 



S$POOL Storage 



X 88 = 352 bytes 

X 40 = bytes 

X 32 = 32 bytes 
X 104 = 104 bytes 






Figure 189. Example 16: User/Message/ Alias/Volume Configuration Worksheet 
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User/ Message /Alias /Volume Configuration Worksheet 



System: Example 16: PC Connect with Inter-LAN Services 
Node Assignment: C3 



Description 


Name 


NA 


Type 


AUas> 


Printer lOCP 


$.100674 


C3AA 


USER 




LCC lOCP 


S.IOOABO 


C3AB 


USER 




PC Connect disk-server lOCP 


$.I01CC8 


C3AC 


USER 




PC Connect lOCP 


$.IO0AA8 


C3AD 


USER 




Application 


SlAP 


C3A0 


USER 




PC LAN C4 Volume Station 


PCVOLD 


C3AE 


VOLUME 





Specify only for alias station 



S$POOL Storage 



5 User/Msg Stations 

Alias Stations 

Remote Stations 



1 Volume Station 



X 88 = 440 bytes 

X 40 = bytes 

X 32 = bytes 

X 104 = 104 bytes 



Figure 190. Example 16: User /Message/ Alias/ Volume Configuration Worksheet 
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Device Configuration Worksheet 



System: Example 16: PC Connect with Inter-LAN Services 
Node Assignment: C3 






Description 


Name 


NA 


Type 


Device Type 


Buffer 
Size 


PDS' 


Polling 
CUDA 


Selection 
CUDAV 
HDCPY' 


Bit Rate' 


Auto 
kas* 


Printer 


LPT2 


C324 


DEVICE 


Printer 


2500 


N 


4040 


0000 







Specify only for printer device station 

Specify only for printer or 4978 device station 

Specify only for 3101 or 31 OIF device station 

Specify only for 3 101 F device station 

For 7485s, bit rate must be 9600 and AUTO ANS=NO. 



.31 OIF Devices 



S$POOL Storage 



xl60 = . 



bytes 



1 4978/Printer Device 

3101 Devices 

Remote Stations 



X 264 = 264 bytes 

X 304 = bytes 

X 32 = bytes 



Figure 191. Example 16: Device Configuration Worksheet 
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Device Configuration Worksheet 



System: Example 16: PC Connect with Inter- LAN Services 
Node Assignment: C2 



Description 


Name 


NA 


Type 


Device Type 


Buffer 
Size 


PDS' 


Polling 
CUDA 


Selection 
CUDAV 
HDCPY' 


Bit Rate' 


Auto 
Ans* 


Printer 


LPTl 


C224 


DEVICE 


Printer 


2500 


N 


4040 


0000 







Specify only for printer device station 

Specify only for printer or 4978 device station 

Specify only for 3101 or 3101 F device station 

Specify only for 31 OIF device station 

For 7485s, bit rate must be 9600 and AUTO ANS=NO. 



.3 101 F Devices 



SSPOOL Storage 



xl60 = . 



. bytes 



1 4978/Printer Device 

3101 Devices 

Remote Stations 



X 264 = 264 bytes 

X 304 = bytes 

X 32 = bytes 



^*V 
\l>^ 



Figure 192. Example 16: Device Configuration Worksheet 
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Line I Terminal I Node Configuration Worksheet 



System: Example 16: PC Connect with Inter- LAN Services 
Node Assignment: C2 



/f "^ 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


Series/ 1 -PC Connect 
Attachment 


PCCDEV 


C2C0 


LINE 


PCC 


4096 


BO 






LCC 


LCCDEV 


C2C1 


LINE 


LCC 


4096 


50 







Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name* 


Polling 

CUDAV 

Portr 


Select 
CUDA' 


PC Node CI 


PCNODECl 


ClOO 


NODE 


PC 




PCCDEV 


PCVOLl 






PC Node C4 


PCNODEC4 


C400 


NODE 


PC 












S/lNodeC3 


NODEC3 


C300 


NODE 


CF 


IF 


LCCDEV 









' Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 
^ Specify only for Local Communications Controller node station 
' Specify only for 3271, 3277, or 3286 terminal station 
'' Specify only for port terminal station 
' Specify only for DCE or DTE line station 
' Specify only for PC node station 






SSPOOL Storage 



_HDLC Lines 



2 Other Lines 

2 Terminals/ Nodes 

1 Remote Station 



xll2 = 



bytes 



X 264 = 528 bytes 
x88= 176 bytes 
X 32 = 32 bytes 



Figure 193. Example 16: Line/Terminal/Node Configuration Worksheet 



^ito^ 
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Line /Terminal /Node Configuration Worksheet 



System: Example 16: PC Connect with Inter-LAN Services 
Node Assignment: C3 



Line Definitions 



Description 


Name 


NA 


Type 


Line Type 


Buffer Size 


Device 
Address' 


Packet Size' 


Window' 


Series/ 1 -PC Connect 
Attachment 


PCCDEV 


C3C0 


LINE 


PCC 


4096 


BO 






LCC 


LCCDEV 


C3C1 


LINE 


LCC 


4096 


50 







Terminal and Node Definitions 



Description 


Name 


NA 


Type 


Term/ 

Node 

Type 


Ring 
Address' 


Line Name 


Volume 
Name* 


Polling 

CUDAV 

Portr 


Select 
CUDA' 


PC Node C4 


PCN0DEC4 


C400 


NODE 


PC 




PCCDEV 


PCVOLD 






PC Node CI 


PCNODECl 


ClOO 


NODE 


PC 












S/lNodeC2 


NODEC2 


C200 


NODE 


CF 


2F 


LCCDEV 









Specify only for Local Communications Controller or 

Series/ 1 -PC Connect Attachment line stations 

Specify only for Local Communications Controller node station 

Specify only for 3271, 3277, or 3286 terminal station 

Specify only for port terminal station 

Specify only for DCE or DTE line station 

Specify only for PC node station 



S$POOL Storage 



.HDLC Lines 



xll2 = 



bytes 



2 Other Lines x 264 = 528 bytes 

2 Terminals/Nodes x 88 = 176 bytes 

1 Remote Station x 32 = 32 bytes 

Figure 194. Example 16: Line/Terminal/Node Configuration Worksheet 



Notice the terminal type of the SNA logical units in Figure 191 on page 436. 



Station Links 



In node C2, you must directly link: 

. LPTl to PCNODECl 
. PCVOLl to PCNODECl 
. PCNODEC4 to NODEC3. 



Sample Configurations 439 



In node C3, you must directly link: 

• LPT2 to PCNODEC4 

. PCVOLD to PCNODEC4 

• PCNODECl to NODEC2. 



/f"\ 



Disk-Server Initialization 



You must allocate a volume for each volume station defined to the system. This 
volume must have the same name as the volume station you have defined. Use the 
EDX utility, $INITDSK, to allocate a volume called PC VOL 1 in node C2 and 
PCVOLD in node C3. 

You can now use the Communications Facility program, $.DSFORM, to create 
data sets to be used as emulated PC disks. You must create these data sets starting 
with the letter following the last physical disk on the gateway PC. Assuming each 
gateway PC has a hard disk, C, use $.DSFORM to create drives D, E, and F on 
PC VOL 1 and PCVOLD. These drives must be in an alphabetic order, else the PC 
Connect disk-server lOCP, $.I01CC8, will not recognize them. 



PC Installation and Setup 



Gateway PC 



This section describes the installation and setup procedures for each PC in this 
example. The two gateway PCs should be installed and setup before the other PCs 
in the network. 

See the Series /I -PC Connect for the Event Driven Executive Communications ^-..^P^ 

Facility for information about installing Series/ 1 -PC Connect Attachment on the 
two gateway PCs, PC 11 and PC21. 

After completing this procedure, use the Series/ 1 -PC Connect customization 
program, SIPCCUST.BAS, to specify the following options for PC 11: 

Option 1 : Enter DD to add another LAN to LAN names list. 
Option 3: Enter LPTl to add the Series/ 1 printer to the emulated 

printer names Ust. 
Option 7: Enter AA to specify the gateway PC's LAN name. 

Using the same customization program, specify the following options for PC21: 

Option 1 : Enter AA to add another LAN to LAN names Ust. 
Option 3: Enter LPT2 to add the Series/ 1 printer to the emulated 

printer names Ust. 
Option 7: Enter DD to specify the gateway PC's LAN name. 

After customizing the two gateway PCs, you can start the Series/ 1 stations. You 
must start the volume stations before you start the PC node stations. IPL the 
gateway PC. 



o 
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Use the IBM PC Network Program to customize each PC in the LAN. Your 
AUTOEXEC.BAT files should look like the following examples: 
D PCll 

£:.*** NETWORK BATCH FILE 
g . ^ *** 

ECHO OFF 

PATH C:\NETWORK 

YNPROMPT Y N 39 Do you want to start the network (Y/N) ? 

IF ERRORLEVEL 1 GOTO A 

ECHO ON 

NET START SRV PCI 1 /SRV:5 /USN : 4 /MBI:8192 /PRE: 16384 /SHR:29 /SES:29 /CMD:25 

NET SHARE DSKD=D:\ 

NET SHARE DSKE=E:\ 

NET SHARE DSKF=F : \ 

NET SHARE KLPT1=LPT1 

S: .A 

IBMS1PC 

DATE 

TIME 

Q PC21 

&:.*** NETWORK BATCH FILE 
g . _ *** 

ECHO OFF 

PATH C:\NETWORK 

YNPROMPT Y N 39 Do you want to start the network (Y/N)? 

IF ERRORLEVEL 1 GOTO A 

ECHO ON 

NET START SRV PC21 /SRV: 5 /USN: 4 /MBI:8192 /PRB: 16384 /SHR:29 /SES:29 /CMC: 25 

NET SHARE DSKD=D : \ 

NET SHARE DSKE=E:\ 

NET SHARE DSKF=F:\ 

NET SHARE KLPT2=LPT2 

£: .A 

IBMS1PC 

DATE 

TIME 



Q PC12 



£:.*** NETWORK BATCH FILE 
g . ^ *** 

ECHO OFF 

PATH A:\;B:\ 

YNPROMPT Y N 39 Do you want to start the network (Y/N) ? 

IF ERRORLEVEL 1 GOTO A 

ECHO ON 

NET START MSG PC12 /ASG:29 /MBI:4096 /SES:29 /CMD:25 

NET USE D: //PC11/DSKD 

NET USE E: //PC11/DSKE 

NET USE F: //PC11/DSKF 

NET USE LPT1 : //PC11/KLPT1 

£: .A 

DATE 

TIME 
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y PC13 

&:.*** NETWORK BATCH FILE 

£:.*** /^ 

ECHO OFF ij J 

PATH A:\;B:\ ^'-"^ 

YNPROMPT Y N 39 Do you want to start the network (Y/N) ? 

IF ERRORLEVEL 1 GOTO A 

ECHO ON 

NET START MSG PCI 3 /ASG:29 /MBI:4096 /SES:29 /CMD:25 

NET USE D: //PC11/DSKD 

NET USE E: //PC11/DSKE 

NET USE F: //PC11/DSKF 

NET USE LPT1 : //PC11/KLPT1 

g: .A 

DATE 

TIME 

Q PC22 

g:.*** NETWORK BATCH FILE 
g . ^ *** 

ECHO OFF 

PATH A:\;B:\ 

YNPROMPT Y N 39 Do you want to start the network (Y/N)? 

IF ERRORLEVEL 1 GOTO A 

ECHO ON 

NET START MSG PC22 /ASG:29 /MBI^4096 /SES:29 /CMD:^5 

NET USE D 

NET USE E 

NET USE F 



//PC21/DSKD 

//PC21/DSKE 

//PC21/DSKF 
NET USE LPT2: //PC21/KLPT2 
g: .A 
DATE 
TIME 

Q PC23 

g:.*** NETWORK BATCH FILE 
g . *** 

ECHO OFF 

PATH A:\;B:\ 

YNPROMPT Y N 39 Do you want to start the network (Y/N) ? 

IF ERRORLEVEL 1 GOTO A 

ECHO ON 

NET START MSG PC23 /ASG:29 /MBI:4096 /SES:29 /CMD:25 

NET USE D: //PC21/DSKD 

NET USE E: //PC21/DSKE 

NET USE F: //PC21/DSKF 

NET USE LPT2: //PC21/KLPT2 

g: .A 

DATE 

TIME 

After all the PCs have completed the AUTOEXEC.BAT procedures, issue the 
following commands on PC22: 

COPY AUTOEXEC.BAT E&:. 

NET PRINT E&: .AUTOEXEC.BAT LPT2 

NETSENDMSGGATEAA.PC12 message text 



4 ~\ 



^Itanw^ 
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Issue the following commands on PC13: 

COPY AUTOEXEC.BAT F&:. 

NET PRINT F&:.AUTOEXEC.BAT LPTl 

NET SEND MSGGATE DD.PC23 message text 

These commands copy a file to an emulated disk. The file is then printed on an 
emulated printer from the emulated disk, and a message is sent to a user on another 

LAN. 
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Maintaining the Communications Facility 



^^, 

\k^ 



This chapter explains how to assemble and link-edit Communications Facility 
programs. 

The name of each source module begins with 'S$'. The prolog of each module 
indicates whether you should use the EDL compiler ($EDXASM) or the Series/ 1 
macro assembler ($S1ASM) to assemble it. 

Some of the Communications FaciUty utihty programs include storage-resident 
message data sets. The name of each source message data set begins with 'S$M'. 
Use the EDX message utility, $MSGUT1, to convert a source message data set to a 
storage resident module. Where the source name is SSMxxxxx, the storage resident 
module name must be OSMxxxxx. 

For information about the various assemblers and linkage editors^^ and the message 
utility see the EDX Operator Commands and Utilities Reference. 

There are four categories of Communications Facility programs: supervisor 
modules, assembler overlay programs, multimodule programs, and single-module 
programs. 



Supervisor Modules 



The supervisor modules add support for the Communications Facility to the EDX 
supervisor. After you have assembled one of these modules, include the object 
module in a link-edit of the EDX supervisor. The source and object names of the 
supervisor modules are: 



Source Module 


Object Module 


S$CSA 


CSA 


S$CSF 


CSF 


S$CSM 


CSM 


S$CSPDIO 


CSPDIO 


S$CSX 


CSX 


S$CSXSYS 


CSXSYS 


s$iNir 


CSXINIT 


S$PCCINT 


CSPCCINT 


S$PCCIPL 


CSPCCIPL 


S$PCCOPN 


CSPCCOPN 
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Source Module 

S$PCCPTC 
S$RDINIT 



Object Module 

CSPCCPTC 
CSXRDINT 



XJ 



Assembler Overlay Programs 



The assembler overlay programs assemble Communications Facility language 
extensions for the $EDXASM assembler. After you have assembled one of these 
modules, use $UPDATE or $EDXLINK to prepare the load module. The source 
and load module names of assembler overlay programs are: 



Source Module 



Load Module 



S$CFID 

S$CFTERM 

S$CSXDEF 

S$GETPUT 

S$SENREC 



A.CFID 

A.CFTERM 

A.CSXDEF 

A.GETPUT 

A.SENREC 



Multimodule Programs 



Some Communications Facility programs consist of more than one source module. 
After you have assembled the modules for a multimodule program, use 
$EDXLINK to prepare the load module. This section shows the components of 
each of these programs. The names given are source module names, unless noted 
otherwise. Some components are distributed in both source and object form; 
where the source module name is S$jcjcxu;x, the object module name is 0%xxxxxx. 



Load Module 


Source or 




Object Module 


$.CFD 


S$CF 




S$DKRD 




S$DKWR 


$.CONFIG 


S$CONFIG 




S$MOPBOG23 




S$MOPFIG23 




S$MOPOPM23 


$.CPCMCF 


S$CPCMCF 




S$CM1MSG 
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Load Module 



$.CPDEF 



$.CPF 



$.CPHELP 



Source or 
Object Module 

S$CPDEF 

S$CPDOVl" 

S$CPDOV2i7 

S$CPDOV3i7 

S$CPDOV4i7 

S$CPDOV5" 

S$CPF 

S$CPFOVli7 

S$CPFOV2i7 

S$CPFOV3i7 

S$CPFOV4i7 

S$CPHELP 
S$CPHLPli7 
S$CPHLP2i7 
S$CPHLP3" 



$.DSFORM 



^r"\_ 



$.IO0AA8 



$.IO0AB0 



$.IO0AB8 



S$DSFORM 
S$DSKUT 
$EDXATSRi8 
$$RETURNi8 

$$SVCi8 

S$IO0AA8 

$EDXATSRi8 

$$DEVLOGi8 

$$RETURN»8 
$$SVCi8 

S$IO0AB0 
$EDXATSRi8 

$$RETURNi8 

S$IO0AB8i9 
S$IO0AB9i' 
S$IO0ABAi9 
S$IO0ABBi9 
S$IO0ABCi9 
S$IO0ABDi9 
S$IO0ABEi9 
S$IO0ABFi9 
$EDXATSRi8 

$$SVCi8 

$$RETURNi8 

$XHCUSR24 
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Load Module 


Source or 




Object Module 


$.IO06F0 


S$IO06F0i9 




S$IO06Fli9 




S$IO06F2i9 




S$IO06F3i9 




S$IO06F5i9 




S$IO06FTi9 




S$IO0634 




$EDXATSRi8 




$$SVC^8 




$DEVLOGi8 




$$RETURNi8 


$.100670 


S$IO0670 




S$IO0679 


$.100674 


S$IO0674 




S$IO0675 




S$IO067622 




S$IO067722 


$.100680 


S$IO0680i9 




S$IO0682i9 




S$IO0683i9 




S$IO0685i9 




S$IO06Fli9 




S$IO068Ti9 




S$IO0634 




$EDXATSRi8 




$$SVCi8 




$DEVLOGi8 




$$RETURNi8 


$.I014E8 


S$I014E8 




$NETCMD2o 




$$SVCi8 




$$RETURNi8 




$NETPACTi8 25 


$.MIGR20 


S$MIGR20 




S$MMGR2023 




S$MOPOPM23 


$.OPAID 


S$OPAID 




S$MOPAID23 




S$MOPBOG23 



/f V. 






"KJ^ 
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Load Module 



$.OPCH 



$.OPCOPY 



$.OPDEF 






$.OPDISP 

$.OPEDIT 

$.OPHELP 
$.OPLINK 

$.OPLIST 

$.OPSETX 

$.PANEL 



Source or 
Object Module 

S$OPCH 
S$OPCHX 
S$MOPCH23 
S$MOPBOG23 

S$OPCOPY 

S$OPNAQ 

S$MOPCPY23 

S$MOPNAQ23 

S$MOPBOG23 

S$OPDEF 

S$OPNAQ 

S$OPCIRC 

S$OPNODE 

S$OPLINE 

S$MOPDEF23 

S$MOPBOG23 

S$MOPNAQ23 

S$OPDISP 

S$MOPDp3 

S$MOPBOG23 

S$OPEDIT 

S$MOPED23 

S$MOPBOG23 

S$OPHELP 
S$MOPHLP23 

S$OPLINK 

S$MOPLIN23 

S$MOPBOG23 

S$OPLIST 

S$MOPLIS23 

S$MOPBOG23 

S$OPSETX 

S$MOPSET23 

S$MOPBOG23 

S$PANEL 
S$PNL001 
S$PNL002 
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Load Module 


Source or 




Object Module 


$.PDIPL 


S$PDIPL 




S$D2IPL 




S$D3IPL 




S$D4IPL 




S$D5IPL 




S$D6IPL 




S$D7IPL 




S$D8IPL 




S$LOIPL 




S$B1IPL 




S$B9IPL 


$.PNLPRT 


S$PNLPRT 




S$PNLPR1 


$.PNLUT1 


S$PNLUT1 




S$PNLPR1 




S$MPNUT123 


$.WSC 


s$wsc 




S$WSCA 


$.WSCUT12i 


S$WSCUT1 




S$WSCUTA 



'"\ 



17 Link as an overlay segment 

18 Object module supplied with EDX 

19 Both source and object modules supplied with the Communications Facility 

20 Object module supplied with EDX-SNA 

21 Specify AUTOCALL $AUTO,ASMLIB to include $IMAGE subroutines 

22 Include for LU-1 support; both source and object modules supplied with the 
Communications Facility 

23 Source message data set 

24 Object module suppUed with EDX XHCS 

25 For EDX Secondary SNA2 only. 
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Single-Module Programs 



The rest of the Communications Facility programs consist of a single source 
module. After you have assembled one of these modules, use $UPDATE or 
$EDXLINK to prepare the load modules. Where the source module name is 
S$jk:jcxxa:;c, the load module name is $.xxxx;xx. 
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Appendix A. Configuring and Connecting 3101 Display Terminals 



The IBM 3101 display tenninals are supported under the Communications Facility 
in character mode only. This appendix contains information to aid you in planning 
the link between the 3101 lOCP, $.IO06F0, and the 3101 display terminals. 



Connecting the 3101 to $.IO06F0 



The 3101 is connected to $.IO06F0 by the attachment features supported by the 
Communications Facility. For each attachment and type of interface, you must set 
the hardware switches on the 3101, physically jumper the attachment card, connect 
the cables, and define the 31 OIF device station. 

Figure 195 shows the Series/ 1 attachment cards that can be used to connect the 
3101to$.IO06F0. 



Attachment Card 


Feature 


Feature Number 


MFA 


Multifunction 
Attachment 


1310 


FPCA 


Feature-Programmable 

Multiline 

Communications 


2095/2096 


FPCA-RPQ 


Asynchronous Direct 
8-Line RS-422A 
Adapter Custom 


2095/RPQ 
D02350 


Terminal/Host 
Adapter 


Series/ 1 System Unit 
Terminal/Host Adapter 


3629 



Figure 195. 3101 Attachment Features 

There are three types of electrical interfaces by which a 3101 can be connected to 
a Series/ 1: 



TTY 



20 milliampere current loop interface 



RS-422A 

EIA RS-422A interface standard 



EIA 



EIA RS-232C/CCnT V.24 interface standard 
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Local 3101 Connections 
Ciurent Loop Interface 



Figure 196 shows the 3101 terminal with the FPCA adapter's current loop 
interface. 







3101 
Terminal 
Models 
12,22 only 


FPCA 


Attachment Cable 


Feature Code 2066 (Part # 6839455) 







Character 
Mode 



figure 196. Current Loop Interface with FPCA 



3101 Switch Setting^: For a current loop interface through the FPCA adapter, you 
may set the 3101 setup switches as follows (ON«l, OFF«0): 

1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 
00010010 0001001110100000 10011001 

These 3101 switch settings indicate a speed of 9600 bps. 

Defining 3101F Device Station: Use the CP DEF DEVICE 3 lOlF command, with 
the following options, to create a station definition in $.SYSNET: 

CP DEF Station-name na DEV 3101F buffsize poll hdcopv bit-rate OFF 

Attachment Optiom: You may set the selection jumpers for the FPCA card as 
follows: 



(L^ 



RTS 


ON 


DTR 


ON 


DCD 


ON 


TTY 


INTERFACE 



RS-422A Interface with FPCA-RPQ 

Figure 197 shows the 3101 terminal with the FPCA-RPQ adapter. 







3101 
Terminal 
Models 
13,23 only 


FPCARPQ 


Attachment Cable 


Feature Code D02352 (Part #6844552) 







Character 
Mode 



Figure 197. RS-422A Interface with FPCA-RPQ 
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3101 Switch Settings: For an RS-422A interface through the FPCA-RPQ adapter, 
you may set the 3101 setup switches as follows (ON»b1, OFF«0): 

1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 
00010010 00010011 10100000 10011001 

These 3101 switch settings indicate a speed of 9600 bps. 

Defining 31 OIF Device StatUm: Use the CP DBF DEVICE 3101F command, with 
the following options, to create a station definition in $.SYSNET: 

CP DEF Station-name na DEV 31 OIF buffsize poll hdcopv bit-rate OFF 
RSA-422A Interface with MFA 

Figure 198 shows the 3101 terminal with the MFA adapter. 



Direct Connection 







3101 
Terminal 
Models 
13,23 only 


MFA 


Attachment Cable 


Feature Code 5770 (Part #6844552) 







Character 
Mode 



Figure 198. RS-422A interface with the MFA 



3101 Switch Settings: For an RS-422A interface through the MFA adapter, you 
may set the 3101 setup switches as follows (0N«1, OFF«0): 

1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 
00010010 00010011 10100000 10011001 

These 3101 switch settings indicate a speed of 9600 bps. 

Defining 3 lOlF Device Station: Use the CP DEF DEVICE 3101F command, with 
the following options, to create a station definition in $.SYSNET: 

CP DEF station-name na DEV 31 OIF buffsize poll hdcopv bit-rate OFF 

Attachment Options: If the 3101 terminal is not defined to EDX, you must use the 
CFTERM instruction to define the 3101 terminal in your EDX supervisor during 
system generation: 

CFTERM ADDRESS= addr . LMODE=RS422 . PRTS=ON 



Figure 199 on page 452.4 shows the 3101 terminal with MFA, FPCA, and 
FPCA-RPQ adapters. 
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MFA 

FPCA 

FPCA-RPQ 



Attachment Cable 



Feature Code 2056 
(Part# 



3101 Cable 



1632211) T 



(Part #5640736) 



3101 
Terminal 
Models 
12,22; 
13,23 only 



■Cable Connectors 
Figure 199. Direct Connection with MFA, FPCA, and FPCA-RPQ 






Character 
Mode 



3101 Smich Settings: For a direct connection through the MFA, FPCA, and 
FPCA-RPQ adapters, you may set the 3101 setup switches as follows (ONs=l, 
OFF=0): 

1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6- 
00110010 00010011 10100000 100110 



7-8 
1 



These 3101 switch settings indicate a speed of 9600 bps. 

Defining 3 lOlF Device Station: Use the CP DEF DEVICE 3 lOlF command, with 
the following options, to create a station definition in $.SYSNET: 

CP DEF Station-name na DEV 31 OIF buffsize poll hdcopv bit-rate OFF 

Attachment Options: You may set the selection jumpers for the FPCA card as 
foUows: 

RTS ON 

DTR ON 

DCD ON 

EIA INTERFACE 



C 



If the 3101 terminal is not defined to EDX, and you are using the MFA card, you 
must use the CFTERM instruction to define the 3101 terminal in your EDX 
supervisor during system generation: 

CFTERM ADDRESS =addr , LMODE=LOCAL , PRTS=ON 



Remote 3101 Connectioiis 



Point-to-Point Nonswitched 



Figure 200 on page 452.5 shows the 3101 terminal with MFA and FPCA 
adapters. 



O 
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Attachment Cable 



Modem 



Feature Code 2057 

(Part #1632208) 

For Japan-2944 (Part #1632919) 

For U.K.-2724 (Part # 1727744) 

Figure 200. Point-to-Point Nonswitched MFA and FPCA 



Modem 



3101 Cable 



(Part # 5640736) 



3101 
Terminal 
Models 
12.22; 
13,23 only 



Character 
Mode 



3101 Switch Settings: For a point-to-point nonswitched connection through the 
MFA and FPCA adapter, you may set the 3101 setup switches as follows (ON^l, 
OFF=0): 

1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 
00110010 00010011 10100000 01010101 



^f^. 



These 3101 switch settings kkdicate a speed of 1200 bps. 

Defining 3101F Device Station: Use the CP DEF DEVICE 3 lOlF command, with 
the following options, to create a station definition in $.SYSNET: 

CP DEF Station-name na DEV 31 OIF buffsize poll hdcopv bit-rate ON 

Attachment Options: You may set the selection jumpers for the FPCA card as 
follows: 

RTS ON 

DTR ON 

DCD ON 

EIA INTERFACE 

If the 3 101 terminal is not defined to EDX, and you are using the MFA card, you 
must use the CFTERM instruction to define the 3101 terminal in your EDX 
supervisor during system generation: 

CFTERM ADDRESS= addr , LMODE=PTTOPT , PRTS=ON 

Modem Options: The selection jumpers for the Series/ 1 modem are set to: 

DTR OFF 
AA ON 
CD OFF 

The selection jumpers for 3101 modem are set to: 

DTR OFF 
AA OFF 
CD ON 
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I Point-to-Point Switched 



Figure 201 shows the 3101 terminal on a point-to-point switched connection with 
the MFA and FPCA adapters. 




Attachment Cable 

Feature Code 2057 

(Part #1632208) 

For Japan-2944 (Part # 1 63291 9) 

For U.K.-2724 (Part #1727744) 

Figure 201. Point-to-Point Switched frith MFA and FPCA 




3101 Cable 



(Part #5640736) 



3101 
Terminal 
Models 
12,22; 
13,23 only 



Character 
Mode 



3101 Smteh Settings: For a point-to-point switched connection through the MFA 
and FPCA adapters, you may set the 3101 setup switches as follows (ONb:1, 
OFF«0): 

1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 1-2-3-4-5-6-7-8 
00110010 00010011 10100000 01010101 

These 3101 switch settmgs indicate a speed of 1200 bps. 

Defining 3101F Device Station: Use the CP DEF DEVICE 3 lOlF command, with 
the following options, to create a station defmition in $.SYSNET: 

CP DEF Station-name na DEV 31 OIF buffsize poll hdcopv bit-rate ON 

Attachment Options: You may set the selection jumpers for the FPCA card as 
follows: 

RTS ON 

DTR OFF 

DCD OFF 

EIA INTERFACE 

If the 3101 terminal is not defined to EDX, and you are using the FPCA card, you 
must use the CFTERM instruction to define the 3101 terminal in your EDX 
supervisor during system generation: 

CFTERM ADDRESS= addr , LMODE=SWITCHED , PRTS=ON 

Modem Options: The selection jumpers for the Series/ 1 modem are set to: 

DTR OFF 
AA ON 

CD 0FF26 



\j^ 



26 You may need to set carrier detect (CD) permanently on your Series/ 1 modem to 
establish a connection between the 3101 and $.IO06F0. 
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The selection jumpers for 3101 modem are set to: 



o 



DTR 


OFF 


AA 


OFF 


CD 


ON 



Remote Dial-in Answering Sequence 



Make sure that the Series/1 modem is powered on before starting the 3101 device 
station. Powering on the modem may ca\ise the ring indicator (RI) to activate 
momentarily. $.IO06F0 interprets this ring indication as an incoming call and 
attempts to answer the line. 

The following sequence of events shows the status of the RS-232C pins between a 
Series/ 1 and a Series/ 1 modem during a remote dial-in operation. 

1. Before the remote 3101 dials in, ensure that request-to-send (RTS) and 
clear-to-send (CTS) are permanantly active on the Series/ 1 modem. 

2. After the remote 3101 modem dials in, the Series/ 1 modem's ring indication 
(RI) is activated. 

3. In response to the first or second ring, $.IO06F0 activates the data terminal 
ready (DTR) signal which activates Uie modem's auto-answer circuits. 

4. When the Series/ 1 modem establishes a connection with the remote 3 101 
modem, the Series/ 1 modem activates data set ready (DSR). At the same 
time, it also activates carrier detect (CD) if supported and if the signal is of 
acceptable quality. 

5. The 3101 modem transmits and receives data from the Series/ 1 or host 
application. 

6. When the station is stopped or halted, $.IO06F0 deactivates DTR, causing the 
Series/ 1 modem to disconnect. 

When using a terminal/host adapter on a 5170 Series/ 1 system unit, you must 
activate carrier detect (CD) on Uie Series/ 1 modem. Activating carrier detect 
causes both carrier detect and data set ready (DSR) to be permanently active. 
Permanent data-set-ready status prevents a tune-out from occurring when 
$.IO06F0 turns on data terminal ready (DTR) in response to the ring indication 
(RI). 
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Glossary 



This is a glossary of technical Communications Facility 
terms that appear in the book. Only terms unique to the 
Communications Facility are defined here. For definitions 
of Event Driven Executive terms, see the appropriate 
EDX book. For definitions of 3270 terms, see the 3270 
Component Description manual. For definitions of 
X.25/HDLC Communications Support terms, see the 
X.25/HDLC Communications Support Programming and 
Operating Reference Manual. For general data processing 
terms see Vocabulary for Data Processing, 
Telecommunications, and Office Systems, GC20-1699. 

<IO>. The transaction identifier associated with the 
Communications Facility program $.PD<IO>. 

$.CF. The name given to the control program after it is 
loaded under the name $.CFD or $.CFS. 



$.HSL. The small, efficient loader used by the program 
dispatcher to load transaction-processing programs. 

$.IO0AA8. The input/output control program that 
manages communication between a Series/ 1 and a 
gateway PC connected by a Series/ 1 -PC Connect 
Attachment. 

$.IO0AB0. The input/output control program that 
manages communication between Series/ Is attached to a 
Local Communications Controller. 

$.IO0AB8. The input/output control program that 
manages X.25 packet level communication between a 
Series/ 1 and a DTE connected by an HDLC Une, with or 
without an intervening X.25 packet-switching data 
network. 






$.CFD. The version of the control program for 
Communications Facility systems that use disk queuing of 
messages. 

$.CFMENU. The sample application program, distributed 
as part of the Communications FaciUty, that demonstrates 
how to communicate with users at 3270-type terminals. 

$.CFS. The version of the control program for 
Communications Facility systems using storage queuing of 
messages. 

$.CONFIG. The utility program that allows the user to 
define and modify stations and maintain the system 
message data set. 

$.DISP. The Communications Facility system station. 

$.DSFORM. The utility program that creates, deletes, or 
renames a data set to be used as an emulated PC disk. 

$.DSINIT. The utility program that initializes a data set 
for the disk queuing of messages. 

$.DSPROF. The control data set that contains 
information about emulated PC disks on a Series/ 1 
volume. 

$.HMU. The transaction-processing program that allows 
an operator at a Series/ 1 to maintain a remote Series/ 1. 



$.IO0AC0. The input/output control program that 
manages 3270 display stations and printers attached to the 
Series/ 1 by a multipoint BSC line. 

$.IO0AD0. The input/output control program that 
provides 3270 emulation when a Series/ 1 is connected to 
a host processor through a channel attachment. 

$.IO0A£0. The input/ output control program that 
provides 3270 emulation when a Series/ 1 is connected to 
a host processor by a multipoint BSC Une. 

$.IO0A10. The input/output control program that 
manages communication between Series/ Is connected by 
a point-to-point BSC line. 

$.IO0A20. The input/output control program that 
manages communication between a Series/ 1 and various 
other systems connected by a point-to-point BSC line. 

$.IO06F0. ( 1 ) The input/output control program that 
manages 3101 display stations attached to the Series/ 1 
through a feature programmable communications adapter, 
or a multipoint attachment, or a 4950/5170-495 
terminal/host adapter as if they were 3277 display 
stations. (2) The renamed $.100680 I/O control program. 

$.100670. The input/output control program that 
manages 4978 display stations with RPQ D02428 and 
4980 display stations as if they were 3277 display stations. 
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$.100674. The input/output control program that 
manages Series/ 1 printers as if they were 3286 printers or 
3287 printers in SCS mode. 

$.100680. The input/output control program that 
manages 7485 display stations attached to the Series/ 1 
through a featm-e programmable communications adapter, 
or a multifunction attachment, or a 4950/5170-495 
terminal/host adapter as if they were 3277 display 
stations. 

$.I01CC8. The input/output control program that 
manages PC read, write, and directory requests to 
Series/ 1 disks. 

$.I014E8. The input/output control program that 
provides 3270 emulation when a Series/ 1 is connected to 
a host processor that uses SNA. 

$.MENU. The data set containing the image used by 
S.WSMENU, in the format created by the EDX utility 
SIMAGE. 

$.PD. The program dispatcher; the program that 
manages the processing of transactions. 

$.PD<IO>. The transaction-processing program that 
performs disk I/O in response to remote disk requests. 

$.PDBSTS. The utility program that allows a user to gain 
exclusive control of a disk volume directory in a remote 
Series/ 1 before loading a program that will update that 
directory. 

$.PDIPL. The transaction-processing program that sends 
an IPL bootstrap to a remote Series/ 1 , causing that 
Series/ 1 to IPL itself. 

$.PDSCHD. The transaction-processing program that 
schedules another transaction for processing at a specific 
time. 

$.PNLUT1 . The utility program that prints the 
descriptions of panels created by the $. PANEL program. 

$.RMU. The transaction-processing program that 
processes transactions received from a host management 
utility — $.HMU or Communications Facility /Host. 

$.RPQCSO. The data set containing the control store for 
the data stream RPQ D02428. 

$.RPQISO. The data set containing the image store for 
the data stream RPQ D02428. 

$.SETSTG. The utility program that changes the size of 
the message buffer pool and file control block pool for 
$.CFD. 

$.SYSIPL. The data set containing CP commands that 
are to be executed when the Communications Facility is 
loaded. 



$.SYSLCC. The data set containing IPL transactions, 
used to IPL remote nodes on a Local Communications 
Controller ring. 

$.SYSMSG. The data set containing the text of error 
messages and informational messages issued by the 
Communications Facility and, optionally, by user 
programs. 

$.SYSNET. The data set containing the definitions of all 
the stations in a node and of remote stations that will be 
communicated with from that node. 

$.SYSPD. The data set containing CP commands, path 
definitions, transaction definitions, and transactions that 
are to be processed when the program dispatcher is 
started. 

$.SYSPNL. The data set containing panels displayed by 
the S.PANEL, $.CFMENU, and $.I014E8 programs. 

$.SYSPRT. The data set containing image and control 
store loads for 4978 terminals and members used to 
support printers as buffered devices. 

$.SYSX25. The data set containing two-digit call IDs and 
their associated X.25 network addresses used during call 
establishment for switched virtual circuits. As shipped, it 
contains 10 records of /*. 

$.UTL The utility program that allows access to various 
Communications Facility functions for diagnostic 
purposes. 

$.UT2. The utility program that allows the user to 
examine and purge messages on the $. WASTE queue or 
any other disk queue. 

$. WASTE. The station to which undeliverable messages 
are sent. 

$.WSC. The work session controller; the part of the 
Communications Facility that allows an application 
program to communicate with multiple EDX devices 
attached to any Series/ 1 in the network. 

$.WSCIMG. The data set containing images that can be 
displayed through the work session controller and 
members used to save data for transaction-processing 
programs. 

$.WSCUT1. The utiUty program that allows a user to 
convert a screen image, prepared through the EDX 
$IMAGE utiUty, for use by the work session controller. 

$.WSMENU. The program used to start a session 
between an EDX terminal and work session controller 
application programs. 

$EDXDEF. The EDX data set that contains the 
definition statements for generation of the EDX 
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supervisor. It must be edited and reassembled when the 
Communications Facility is installed. 

$INITIAL. The program that is loaded when EDX is 
IPLed. 

$PCCROn. The data set that contains patches to the 
Series/ 1 -PC Connect Attachment microcode, n is the EC 
level. 

$LNKCNTL. The EDX data set that contains the linkage 
editor statements necessary to generate the EDX 
supervisor. It must be edited when the Communications 
Facility is installed or when certain devices are added to 
an existing Communications Facility system. 

$STORAGE. The label in the EDX program header that 
contains the address of the program's dynamic storage 
area. The Communications Facility books call the dynamic 
storage area $STORAGE. 

$4980CSA. The data set containing the control store for 
a 4980 terminal managed by the Communications Facility. 

$4978CS0. The data set containing the control store for 
a 4978 terminal managed by EDX. 

$4980CS0. The data set containing the control store for 
a 4980 terminal managed by EDX. 

$4980ISA. The data set containing the image store for a 
4980 terminal managed by the Communications Facility. 

$4978180. The data set containing the image store for a 
4978 terminal managed by EDX. 

$4980180. The data set containing the image store for a 
4980 terminal managed by EDX. 

$4980R0A. The data set containing the microcode 
random access memory for a 4980 managed by the 
Communications Facility. 

$4980R01. The data set containing the microcode 
random access memory for a 4980 terminal managed by 
EDX. 

alias station. A station that defines an alternate name for 
another station in a Communications Facility 
configuration. 

alphanumeric mode. An attribute of a 4978 device station 
that allows the user to enter any characters in a numeric 
field. Contrast with numeric mode. 

alternate link vector. The network address of a station 
that is the alternate destination for messages sent to a 
particular station. Undeliverable transactions and X.25 
control messages are sent to a station's alternate 
destination. 



asynchronous adapter. A term used to mean feature 
programmable communications adapter, multifunction 
attachment, or 4950/5170-495 terminal/host adapter. 

basic mode. An attribute of a station that causes messages 
sent to or received from it to be transferred without 
addition or removal of control characters. Contrast with 
record mode. 

BCUG (bOateral closed user group). The X.25 facility that 
allows two DTEs to establish communication with each 
other by simply specifying a BCUG ID. Additional 
benefits vary with the network provider. 

bilateral closed user group (BCUG). The X.25 facility that 
allows two DTEs to establish communication with each 
other by simply specifying a BCUG ID. Additional 
benefits vary with the network provider. 

buffer, Communications Facility. A storage area, from 1 to 
32K bytes long, preceded by a buffer header. 

buffer header. Five words preceding a Communications 
Facility buffer that contain information about the size and 
content of the buffer. 

buffer reference block (BRB). The first 4 words of a 
workspace pool, used to control the allocation of buffers 
and workspaces from the pool. 

buffered device. A printer supported in a way that allows 
data to be retained and merged with variable data on write 
operations. 

call accept control message. The Communications Facility 
message sent by an application program to indicate it is 
ready to receive data from a remote DTE through a 
switched virtual circuit. Call accept is sent in response to 
an incoming call control message. 

call connected control message. The Communications 
Facility message sent by the X.25 I/O control program to 
a STD+ circuit station's direct or alternate link to indicate 
that the remote DTE has accepted the call initiated by the 
circuit station. The circuit station may now send data 
through the network. 

call ID. A user-defined two-digit number that represents 
an X.25 network address. Call IDs are used when defining 
a switched virtual circuit station if calls are to be sent to or 
received from a specific X.25 network address. Call IDs 
are associated with X.25 addresses in the $.SYSX25 data 
set. 

caU request control message. The Communications 
Facility message sent by an application program to a 
circuit station with a contact type of USERINIT to initiate 
a virtual call to a remote DTE. 

cause code. A 1-byte code in a restart, clear, or reset 
packet that indicates the reason for the restart, clear, or 
reset. The X.25 I/O control program includes this code in 
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log and control messages that it sends as a result of 
receiving them from XHCS. 

CCITT. International Telephone and Telegraph 
Consultative Committee. An organization of common 
carriers and PTTs whose main goal is to recommend 
standards that facilitate interconnection of 
communications equipment. 

cell. A node in the Communications FaciUty 
configuration in which the program dispatcher runs or a 
non-Series/ 1 host system where transactions are 
processed. 

CELL. The statement in $.SYSPD that identifies the 
local cell. 



cell identifier. 

a cell. 



A 2-character name that uniquely identifies 



CFBUF. The message buffer pool; a workspace pool in 
the Communications Facility control program that 
contains storage-queued messages. 

CFTERM. The instruction that defines a 3 101 or 7485 
terminal, on a multifunction attachment, that is intended 
for Communications Facility use only. 

circuit station. A station that represents an X.25 virtual 
circuit. See also virtual circuit. 

clear confirmation control message. The Communications 
Facility message sent by the X.25 I/O control program to 
the STD+ circuit station's direct or alternate link 
informing it that the switched virtual circuit has been 
cleared as a result of a clear request control message sent 
by the circuit station. 

clear indication control message. The Communications 
Facility message sent by the X.25 I/O control program to 
a STD+ circuit station informing it that the remote DTE 
has issued a clear request for the switched virtual circuit. 

clear request control message. The Communications 
Facility message sent by an application program to a 
STD+ circuit station as a negative response to an 
incoming call or at any time it wants to clear the switched 
virtual circuit. 

closed user group (CUG). The X.25 facility that defines a 
group of DTEs that can communicate with each other. 
The number of DTEs that can be in a group and additional 
benefits vary with the network provider. 



command message. 
CP command. 



A message, the content of which is a 



command processor. A part of the Communications 
Facility that processes CP and, with the program 
dispatcher, PD commands. 



command processor (CP) commands. A set of 

Communications Facility commands used to define and 
control the Communications Facility configuration and 
display information about it. 

command-processing program. A program that processes a 
particular CP command. The command processor controls 
loading and execution of command-processing programs 
as it receives commands. 

Communications Facility buffer. A storage area, from 1 to 
32K bytes long preceded by a buffer header. 

Communications Facility configuration. A complete set of 
nodes, cells, and stations that communicate with one 
another through the Communications Facility. 

Communications Facility/Host. The program that allows 
an operator at a System/370, a 30xx, or a 4300 to 
maintain a remote Series/ 1 . 

Communications Facility terminal. A device defined to the 
Communications Facility, controlled by an I/O control 
program, and accessed from a program through SEND and 
RECEIVE instructions. 

configuration processor ($.CONFIG). The utility program 
used to define and modify stations and maintain the 
system message data set. 

control message. A message defined by the 
Communications Facility that contains information related 
to controlling the X.25 network. Circuit stations with a 
usage type of STD+ and the X.25 I/O control program 
can send and receive these messages using the SEND S 
and SEND SM instructions. The length of the control 
message varies depending on which type it is. See also the 
name of the individual control message. 

control program ($.CF). The part of the Communications 
Facility that includes message dispatching functions, the 
command processor, and the log processor. 

control, 3270 ($.IO0AC0). The input/output control 
program that controls 3270 displays and printers attached 
to the Series/ 1. 

CP commands. A set of Communications FaciUty 
commands used to define and control the Communications 
Facility configuration and display information about it. 

CSPDIO. A module in the EDX supervisor that provides 
remote disk support. 

CUG (closed user group). The X.25 facility that defines a 
group of DTEs that can communicate with each other. 
The number of DTEs that can be in a group and additional 
benefits vary with the network provider. 

data circuit-terminating equipment (DCE). The equipment 
installed at the user's premises that provides all the 
functions required to establish, maintain, and terminate a 
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connection, including the signal conversion and coding 
between the data terminal equipment (DTE) and the line. 
In the Communications Facility, software functions 
provide a connection point for devices capable of 
interfacing to a packet-switching data network as DTEs. 
The Communications Facility does not provide all the 
DCE support defined by Recommendation X.25; it cannot 
be an X.25 network. 

data message. A message, the content of which is user 
data to be sent from one station to another. 

data stream RPQ. An RPQ (D02428) that improves 
performance when a 4978 display station is managed as if 
it were a 3277 display station. 

data terminal equipment (DTE). That part of a data 
station that serves as a data source, data sink, or both, and 
provides for the data communication control function 
according to protocols. In the Communications Facility, 
DTE is hardware or software that is capable of attaching 
to an X.25 packet-switching network. 

D-bit. A bit in an X.25 packet header that instructs the 
network to wait until delivery to the remote data terminal 
equipment has been confirmed before confirming delivery 
to the sending data terminal equipment. As data 
circuit-terminating equipment (DCE), the 
Communications Facility confirms only that the SEND M 
instruction to the local appUcation program has completed 
successfully; it does not wait for confirmation of receipt of 
the message. 

DCE (data circuit-terminating equipment). The equipment 
installed at the user's premises that provides all the 
functions required to establish, maintain, and terminate a 
connection, including the signal conversion and coding 
between the data terminal equipment (DTE) and the line. 
In the Communications FaciUty, software functions 
provide a connection point for devices capable of 
interfacing to a packet-switching data network as DTEs. 
The Communications Facility does not provide all the 
DCE support defined by Recommendation X.25; it cannot 
be an X.25 network. 

DDM (device descriptor module). An XHCS module that 
defines an HDLC line. The name of the Communications 
Facility line station representing the line must have the 
same name as its DDM. 

DDSK-30. The 30 megabyte disk within the 4952, 4954, 
or 4956 processor or within the 4965 storage and I/O 
expansion unit. Because DDSK-30 is the keyword on the 
EDX DISK statement, EDX and Communications Facility 
books use it to identify the disk unit. 

DDSK-60. The 60 megabyte disk within the 4954 or 
4956 processor or within the 4965 storage and I/O 
expansion unit. Because DDSK-60 is the keyword on the 
EDX DISK statement, EDX and Communications Facility 
books use it to identify the disk unit. 



DEF. The CP command that defines a new station. 

DEFINE BRB. The instruction that defines a buffer 
reference block; storage following this instruction will be 
treated as a workspace pool. 

DEFINE BUFFERPOOL. The instruction that defines a 
workspace pool within a program. This is the same 
instruction as DEFINE POOL and DEFINE WORK. 

DEFINE DEVICE. The instruction that defines a device 
descriptor block for a remote disk. 

DEFINE POOL. The instruction that defines a 
workspace pool within a program. This is the same 
instruction as DEFINE BUFFERPOOL and DEFINE 
WORK. 

DEFINE VOLUME. The instruction that makes an entry 
for a remote disk volume in the volume descriptor 
cross-reference table. 

DEFINE WORK. The instruction that defines a 
workspace pool within a program. This is the same 
instruction as DEFINE BUFFERPOOL and DEFINE 
POOL. 

delivery confirmation bit (D-bit). A bit in an X.25 packet 
header that instructs the network to wait until delivery to 
the remote data terminal equipment has been confirmed 
before confirming delivery to the sending data terminal 
equipment. As data circuit-terminating equipment (DCE), 
the Communications Facility confirms only that the SEND 
M instruction to the local application program has 
completed successfully; it does not wait for confirmation 
of receipt of the message. 

device descriptor module (DDM). An XHCS module that 
defines an HDLC line. The name of the Communications 
Facility line station representing the line must have the 
same name as its DDM. 

device station. A station that represents a Series/ 1 
terminal or printer to be managed as if it were a 3270 
device in the Communications Facility configuration. 

device type. The combination of station type and station 
subtype for a Series/ 1 terminal or printer being managed 
as if it were a 3270 device. Device type indicates which 
I/O control program is to control a particular device. 

diagnostic aid utility ($.UT1). The utility program that 
allows access to various Communications Facility 
functions for diagnostic purposes. 

diagnostic code. An optional 1-byte code in restart, reset, 
and clear packets that gives information about the reason 
for the restart, reset, or clear. The X.25 I/O control 
program includes this code, if XHCS sent it, in the log and 
control messages. 
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direct link vector. The network address of a station that is 
the default destination for messages sent by a particular 
station. 

disk-server. A function supported by the Series/ 1 -PC 
Connect Program which allows a PC user to use a 
Series/ 1 data set as a LAN-shared PC disk. 

disk queue. A message queue on disk, used to hold 
low-priority messages destined for a particular station until 
the station is ready to receive them. 



program, program number 5719-XX9. This program is an 
extension of the EDX Secondary SNAl. It allows users to 
define up to four PUs in a Series/ 1. 

EDX Secondary SNAl support. The set of 
Communications Facility modules neccessary to use EDX 
Secondary SNA2 and up to four Communications Facility 
SNA PU stations in a Series/ 1. 

EDX terminal. A terminal defined to the EDX operating 
system and used to perform EDX system functions. 






disk-queue data set. A data set used to hold low-priority 
messages destined for a particular station until the station 
is ready to receive them. 



emulated PC disk management utility ($.DSFORM ). The 

utility program that creates, deletes, or renames a data set 
to be used as an emulated PC disk. 



disk-queue data set initialization utility ($.DSINIT). The 

utility program that initializes a data set for the disk 
queuing of messages. 

disk-queue fUe control block. A control block that 
contains information about a station that has a disk queue. 

disk, remote. A feature of the Communications Facility 
that allows a program to access a disk volume that is 
attached to another Series/ 1. 

dispatcher, message. The part of the Communications 
Facility that determines the final destination of a message 
and routes it through the system to that destination. 

dispatcher, program ($.PD). The part of the 
Communications Facility that manages the processing of 
transactions. 



emulated PC disks. A Series/ 1 data set formatted as a 
Personal Computer (PC) disk. 

emulation, 3270. The facility that allows a host processor 
to communicate with a Series/ 1 as if it were 
communicating with a 3270 system; also, the I/O control 
program that provides 3270 emulation over a BSC line 
($.IO0AE0). 

EQU. A statement in $.SYSPD that defines a transaction 
that has attributes similar to another transaction. 

error indication control message. The Communications 
Facility message sent by the X.25 I/O control program to 
a STD+ circuit station's direct or alternate link to indicate 
that the I/O control program rejected a control message 
or that it could not initiate a call for an SVC circuit 
station. 






DTE (data terminal equipment). That part of a data 
station that serves as a data source, data sink, or both, and 
provides for the data communication control function 
according to protocols. In the Communications Facility, 
DTE is hardware or software that is capable of attaching 
to an X.25 packet-switching network. 

dynamic partition. An EDX partition in which the system 
must allocate I/O segmentation registers for each I/O 
request issued and deallocate them when the I/O 
operation completes. 

EDL language extensions. A set of Event Driven 
Executive Language (EDL) instructions that perform 
various Communications Facility functions. 

EDX Secondary SNAl. The IBM Series/ 1 Event Driven 
Executive Systems Network Architecture Ucensed 
program, program number 5719-SXl. EDX Secondary 
SNAl allows an EDX user application, such as the 
Communications Facility SNA lOCP, to communicate 
with host applications through an SDLC connection using 
SNA protocols. 

EDX Secondary SNA2. The IBM Series/ 1 Event Driven 
Executive Systems Network Architecture licensed 



error log. EDX uses the $LOG utility to log errors to a 
disk or diskette data set. 

error message. A message sent to the Communications 
Facility system log to indicate that an error has occurred. 

F. (1) The CP command that modifies the attributes of 
an existing station. (2) The PD command that modifies an 
entry in the path table or the transaction identifier table. 

facilities. A set of optional characteristics and capabilities 
available from the network provider to switched virtual 
circuits during call establishment. In the Communications 
Facility, these facilities may be included in the SVC circuit 
station definition and/or in a call request control message 
from an application program. See also the individual 
facility. 

fast select (FS). The X.25 facility that allows data to be 
appended to a call request, call clear, or call accept packet. 
Contrast with fast select restricted. 

fast select restricted (FSR). The X.25 faciUty that allows 
data to be appended to a call request or call clear packet. 
Call accept packets are not allowed. Contrast wiih fast 
select. 
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FCB (file control block). A control block that contains 
information about a station that has a disk queue. 

FILE. The CP command that displays disk-queuing 
parameters and changes or assigns a station's data set 
name for disk-queuing. 

ffle control block (FCB). A control block that contains 
information about a station that has a disk queue. 

FS (fast select). The X.25 facility that allows data to be 
appended to a call request, call clear, or call accept packet. 
Contrast with/a5/ select restricted. 

FSR (fast select restricted). The X.25 facility that allows 
data to be appended to a call request or call clear packet. 
Call accept packets are not allowed. Contrast with /a5/ 
select. 

gateway PC. A Personal Computer (PC) connected to a 
Series/ 1 by the Series/ 1 -PC Connect Attachment. 

GET B. The instruction that gets a buffer from a 
workspace pool. 

GET S. The instruction that gets storage from the system 
storage pool, S$POOL. 

GET W. The instruction that gets storage from a 
workspace pool. 

halted station. A station whose station block has been 
deleted from S$POOL. 

HDLC (high-level data link control). The group of 
standards defining the link level for communications with 
a public data network. As defined by Recommendation 
X.25, LAPB conforms to one subset of standards and 
SDLC normal response mode conforms to a different 
subset. The Communications Facility adheres only to the 
LAPB subset. 

header, buffer. Five words preceding a Communications 
Facility buffer that contain information about the size and 
content of the buffer. 

header, message. 24 bytes at the beginning of a message 
that contain such information as its origin, destination, and 
priority. 

high-speed loader ($.HSL). A small, efficient loader used 
by the program dispatcher to load transaction-processing 
programs. 

hold, input. A condition of a station in which all messages 
it sends are discarded. 



host communication. A function supported by the 
Series/ 1 -PC Connect Program which allows a PC user to 
pass through to one or multiple hosts as a 3278 or to 
transfer files to and from any host over SDLC. 

host management utiUty (S.HMU). The 

transaction-processing program that allows an operator at 
a Series/ 1 to maintain a remote Series/ 1. 

host processor. A computer in a Communications Facility 
configuration where control functions are performed; it 
may be a Series/ 1 or another type of computer. 

image library. A library of screen images in data set 
$.WSCIMG that can be displayed through the work 
session controller BI command. 

image library management utility ($.WSCUT1). The utility 
program that converts a screen image that was created by 
the EDX $IMAGE program and stores it in $.WSCIMG 
for use by the work session controller. It is also used to 
display the image. 

incoming call control message. The Communications 
Facility message sent by the X.25 I/O control program to 
a STD+ circuit station to indicate that a remote DTE 
wishes to begin communications. 

initialization data set ($.SYSIPL). A data set containing 
CP commands that is read when the Communications 
Facility is loaded. 

input hold. A condition of a station in which all messages 
it sends are discarded. 

input/output control program (lOCP). A program that 
handles transmission of messages to and from a particular 
type of device or line in a Communications Facility 
configuration. 

inter-LAN. A function supported by the Series/ 1 -PC 
Connect Program which allows a PC to communicate with 
other computers on another LAN. 

interrupt confirmation control message. The 

Communications Facility message sent by the X.25 I/O 
control program to a STD+ circuit station informing it 
that the remote data terminal equipment received an 
interrupt control message sent by the circuit station. 

interrupt control message. The Communications Facihty 
message sent by an application program to a STD+ circuit 
station or by the X.25 I/O control program to a STD+ 
circuit station's direct or alternate link. The interrupt 
control message includes 1 byte of data that is sent across 
the X.25 circuit without flow control. 



hold, output. A condition of a station in which messages 
can be sent to it, but it can't receive messages from its 
queue. 



lOCP (input/output control program). A program that 
handles transmission of messages to and from a particular 
type of device or Une in a Communications Facility 
configuration. 
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IPL transaction data set ($.SYSLCC). The data set 
containing IPL transactions, used to IPL remote nodes on 
a Local Communications Controller ring. 

LAN (local area network). A PC network created when 
Personal Computers are connected by hardware and 
provided with software support to enable them to 
communicate with each other. 

language extensions. A set of Event Driven Executive 
Language (EDL) instructions that perform various 
Communications Facility functions. 



log message. A message that is sent to the 
Communications Facility system log. 

log processor. The part of the Communications Facility 
that formats error and informational messages and sends 
them to the system log. 

logical channel. A logical conduit for packets on a 
DTE-to-DCE link. Logical channels are assigned to 
virtual circuits dynamically (SVCs) or statically (PVCs). 
All packets on the circuit flow through the logical channel. 
See also logical channel identifier. 
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LAN-shared disk. A Series/ 1 data set formatted as an 
emulated PC disk that is shared by the PCs in the same 

LAN. 

LAN -shared printer. A Series/ 1 printer used as an 
emulated PC printer that is shared by the PCs in the same 

LAN. 

LAPB (link access procedure balanced). The link protocol 
used by the XHCS for controlhng the X.25 network 
access Unk. 

LCI (logical channel identifier). A number assigned to a 
logical channel to uniquely identify the channel and all 
packets flowing through it. In the Communications 
Facility, permanent virtual circuits have LCIs in their 
station definitions to assign them to that particular logical 
channel. 

line station. A station that represents a 
telecommunication line in a Communications Facihty 
configuration. 

line type. The combination of station type and station 
subtype for a communication Une. Line type indicates 
which I/O control program (such as point-to-point or 
3270 control) is to control a particular line. 



logical channel identifier (LCI). A number assigned to a 
logical channel to uniquely identify the channel and all 
packets flowing through it. In the Communications 
Facility, permanent virtual circuits have LCIs in their 
station definitions to assign them to that particular logical 
channel. 

logical unit (LU) station. A station that represents an SNA 
logical unit (a terminal or a printer) in a Communications 
Facihty configuration. 

LS. The work session controller command that sets a 
lock sequence for a static screen terminal. 

LU (logical unit) station. A station that represents an SNA 
logical unit (a terminal or a printer) in a Communications 
Facihty configuration. 

mapped partition. A partition that contains the common 
area (system tables and station blocks). 

message. A unit of data to be transmitted from one 
station to another. 

message buffer pool (CFBUF). A workspace pool in the 
Communications Facihty control program that contains 
storage-queued messages. 



LINK. ( 1 ) The CP or $ .CONFIG command that defines 
a connection between two stations — either a direct link 
vector or an alternate Unk vector. (2) The work session 
controller high-level language subroutine that enables an 
application program to complete its own execution by 
loading and executing some other appUcation program. 

linked station. A station that has a single specified station 
as the default destination of messages it sends. 

local area network (LAN). A PC network created when 
Personal Computers are connected by hardware and 
provided with software support to enable them to 
communicate with each other. 

local node. The node from which the Communications 
Facihty configuration is being viewed. 

local station. A station that exists at the local node. 



message data set ($.SYSMSG). The data set containing 
the text of error messages and informational messages 
issued by the Communications Facihty and, optionally, by 
user programs. 

message dispatcher. The part of the Communications 
Facihty that determines the final destination of a message 
and routes it through the system to the destination. 

message header. 24 bytes at the beginning of a message 
that contain such information as the origin, destination, 
and priority of the message. 

message priority. An attribute of a message that 
determines where it is placed in the destination station's 
message queue. 

message queue. A queue of messages destined for a single 
station, either in processor storage or on disk. 
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message queue management utility ($.UT2). The utility 
program that allows the user to examine and purge 
messages on the $. WASTE queue or any other disk queue. 

message sequence number. A number associated with a 
message representing its sequence with respect to its 
origin. 

message station. A queue of messages, not associated 
with a Communications Facility program or device. 



packet. The basic transmission unit on a data link 
accessing an X.25 network. See also packet size. 

packet size. The size of the largest data packet sent to an 
X.25 network. The packet size is defined in the circuit or 
DxE line station definitions. 

packet smtching. The process of routing and transferring 
data by means of addressed packets so that a channel is 
occupied only during the transmission of a packet. 



message type. An attribute of a message that indicates 
whether it is a data, command, log, transaction, or status 
message. 

MOV. The instruction that moves data, allowing indirect 
and indexed moves. 



packet-switching data network (PSDN). A 

communications network that uses the mechanism of 
packet switching to transmit data. See also packet 
switching. 

page. In EDX, a 256-byte block of storage. 



multinode mode. A mode of operation of the message 
dispatcher that allows routing of messages to stations in 
remote nodes. 

name, station. A 1- to 8-character alphanumeric value 
that uniquely identifies each station in a node. 



panel. A screen image for a 3270 display station or a 
Series/ 1 device being managed as a 3270 display station. 

panel data set ($.SYSPNL). The data set containing 
panels displayed by the $.PANEL, $.CFMENU, and 
$.IO014E8 programs. 



network address. A 4-character hexadecimal value that 
uniquely identifies a station in the network. The first two 
characters are the node assignment, and the last two are 
the station address. 

network configuration data set ($.SYSNET). The data set 
containing the definitions of all the stations in a node and 
of remote stations that will be communicated with from 
that node. 

node. A Series/ 1 in the Communications Facility 
configuration. 

node assignment. The first 2 characters of a station's 
network address; they uniquely identify a node in the 
network. 

node station. A station that represents a remote node in a 
Communications Facility configuration. 

non-display mode. An attribute of a terminal or device 
station that causes lowercase data to be converted to 
uppercase. For 4978 device stations, it also causes 
non-display output fields to be converted to lowercase, 
which displays as blanks. Contrast with text mode. 

nontransparent mode. A mode of BSC transmission that 
prohibits bit patterns with a value less than X'40' from 
being transmitted as data. 

numeric mode. An attribute of a 4978 device station that 
allows the user to enter only digits, decimal points, and 
minus signs in a numeric field. Contrast with 
alphanumeric mode. 

output hold. A condition of a station in which messages 
can be sent to it, but it can't receive messages from its 
queue. 



panel design aid ($.PANEL). An interactive program for 
creating panels to be displayed at a 3270-type terminal. 

panel print utility ($.PNLUT1). The utiUty program that 
prints the descriptions of panels created by the $. PANEL 
program. 

pass-throi^h. In the Communications Facility, the facility 
that allows users of Series/ 1 and 3270 devices on the 
Series/ 1 to communicate with host applications without 
any additional application programs in the Series/ 1. The 
devices on the Series/ 1 appear as 3270 devices to the host 
application. 

passthrough control message. The Communications 
Facility message that contains user-defined control 
information. The X.25 I/O control program sends this 
message to the circuit station's direct or alternate link 
when it receives a message with the Q-bit on in an 
incoming data packet. The application program sends this 
message to a STD+ circuit when it wants the data sent in 
a data packet with the Q-bit on. 

path. The route used to send a transaction from the 
program dispatcher in one cell to the program dispatcher 
in another cell or to a host transaction-processing system, 

PATH. A statement in $.SYSPD that defines a path. 

path definition table. A table used by the program 
dispatcher that defines the paths to remote cells. 

path table. Synonymous with path definition table. 

PCC. The instruction that defines a Series/ 1 -PC 
Connect Attachment to the EDX supervisor. 
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PC header. A 20-byte storage area prefixed to the data 
sent from the gateway PC. It contains information such as 
the origin and destination stations, data length, and 
function identifiers. 

PD commands. A subset of Communications Facility CP 
commands used to control the operation of the program 
dispatcher. 

Personal Computer. As used in Communications Facility, 
an IBM Personal Computer. 

permanent virtual circuit (PVC). A permanent virtual 
connection that provides services similar to a leased line. 
Data sent to the network through a logical channel being 
used as a PVC is always delivered to a specific logical 
channel at a specific DTE destination in the network. In 
the Communications Facility, PVC circuit stations 
represent permanent virtual circuits. 

physical unit (PU) station. A station that represents an 
SNA physical unit in a Communications Facility 
configuration. 



preferred path. 

unknown cells. 



The path used to route transactions for 



printer data set ($.SYSPRT). The data set containing 
image and control store loads for 4978 terminals and 
members used to support printers as formatted devices. 

priority, message. An attribute of a message that 
determines where it is placed in the destination station's 
message queue. 

program dispatcher ($.PD). The part of the 
Communications Facility that manages the processing of 
transactions. 

program dispatcher (PD) commands. A subset of 
Communications Facility CP commands used to control 
the operation of the program dispatcher. 

program dispatcher data set ($.SYSPD). The data set 
containing CP commands, path definitions, transaction 
definitions, and transactions, that are to be processed 
when the program dispatcher is started. 

program-to-program communication. A function 
supported by the Series/ 1 -PC Connect Program which 
allows a PC user to communicate between PC programs 
on separate IBM PC networks or to commimicate between 
Series/ 1 programs and PC programs. 

protocol identifier (ID). The optional 4-byte field 
included in the user data portion of a call request or 
incoming call packet that provides an additional means of 
screening incoming calls from an X.25 network. In the 
Communications Facility, switched virtual circuit station 
definitions may include a protocol ID. 



PSDN (packet-switching data network). A 

communications network that uses the mechanism of 
packet switching to transmit data. See also packet 
switching. 

PU (physical unit) station. A station that represents an 
SNA physical unit in a Communications Facility 
configuration. 



PUT TCB. 

block. 



The instruction that creates a task control 



PVC (permanent virtual circuit). A permanent virtual 
connection that provides services similar to a leased line. 
Data sent to the network through a logical channel being 
used as a PVC is always delivered to a specific logical 
channel at a specific DTE destination in the network. In 
the Communications Facility, PVC circuit stations 
represent permanent virtual circuits. 

Q. (1) The CP command that displays information about 
Communications Facility stations, BSC lines, EDX 
terminals, EDX-SNA control blocks, and EDX-XHCS 
control blocks. (2) The PD command that displays the 
transaction identifier table, the path definition table, 
remote disk definitions, and scheduled transactions. 

qualifier bit (Q-bit). A bit in a data packet header that 
indicates the type of information in the pae4£et. Q-bit of 
(off) means the data is user data; Q-bit of 1 (on) means 
the data is application-defined control data. 
Communications Facility application programs send and 
receive control data in the passthrough control message. 

queued message utility ($.UT2). The utility program that 
allows the user to examine and purge messages on the 
$. WASTE queue or any other disk queue. 

R. The PD command that removes an entry from the 
path table or the transaction identifier table. 

RC. (1) The PD command that sets the number of times 
the program dispatcher will attempt to load a program 
when storage is not available. (2) The work session 
controDer command that reads the cursor position from a 
static screen terminal. 

reason code. A code indicating the reason an 
undeliverable message is in the $.WASTE queue. 

recognized private operating agency (RPOA). The X.2S 
facility that defines a particular transit network through 
which a virtual call is to be routed internationally, when 
more than one RPOA transit network exists at an 
international gateway. 

Recommendation X.25. The CCITT recommendation that 
defines standards for the connection of processing 
equipment to a packet-switching data network. It 
addresses the physical level, the link level, and the packet 
level. The Communications FaciUty adheres to the 
recommendation as amended in 1981. 
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record mode. An attribute of a station that causes control 
characters to be removed from messages received from it 
and control characters added, if necessary, to messages 
sent to it. Contrast with basic mode. 

remote ceU. Any cell in the Communications Facility 
configuration other than the local cell. 

remote disk support. A feature of the Communications 
Facility that allows a program to access a disk volume that 
is attached to another Series/ 1 . 

remote IPL utility ($.PDIPL). The transaction-processing 
program that sends an IPL bootstrap or nucleus to a 
remote Series/ 1, causing that Series/ 1 to IPL itself. 

remote management utility ($.RMU). The 

transaction-processing program that processes transactions 
received from a host management utiUty — $.HMU or 
Communications Facility /Host. 

remote node. Any node in the Communications Facility 
configuration other than the local node. 

remote station. A station in a remote node. 

RESERVE. A statement in $.SYSPD that reserves space 
in the path table or the transaction identifier table. 

reset confirmation control message. A Communications 
Facility message sent by the X.25 I/O control program to 
a STD+ circuit station's direct or alternate link informing 
it that the circuit has been reset as a result of a reset 
initiated by the application program. 



RPOA (recognized private operating agency). The X.25 
facility that defines a particular transit network through 
which a virtual call is to be routed internationally, when 
more than one RPOA transit network exists at an 
international gateway. 

RTE. A statement in $.SYSPD that overrides a 
transaction's primary cell identifier. 

S$CFEQU. The Communications Facility system equate 
table, which defines names for the fields of the station 
blocks, the buffer header, and the message header. 

S$POOL. The system storage pool; a workspace pool in 
the common area, used by the Communications Facility 
for station blocks and work areas. 

SC. The work session controller command that positions 
the cursor on a static screen terminal. 

SCHD. The transaction identifier associated with the 
Communications Facility program $.PDSCHD. 

scheduler ($.PDSCHD). The transaction-processing 
program that schedules another transaction for processing 
at a specific time. 

SCS (SNA character string). A character string composed 
of EBCDIC controls, optionally intermixed with end-user 
data, that is carried within a request/response unit. 

SCS mode. An attribute of a printer device station that 
causes data sent to it to be interpreted as an SNA 
character string. Contrast with 3270 mode. 



reset indication control message. A Communications 
Facility message sent by the X.25 I/O control program to 
a STD+ circuit station's direct or alternate link informing 
it that the circuit has been reset by the remote data 
terminal equipment or as a result of an error detected by 
the network or XHCS. 

reset request. A Communications Facility message sent 
by the STD+ circuit station to reinitialize the virtual call 
or the permanent virtual circuit. Reinitialization removes 
all data and interrupt packets in the network. 

RETRY mode. An attribute of a circuit station that 
causes the I/O control program to reestablish the virtual 
call when a call is cleared for a switched virtual circuit 
whose contact type is INIT. Contrast with STOP mode. 



secondary cell identifier. A field of a transaction, whose 
meaning is defined by the program that processes the 
transaction. It may, for example, be the identifier of the 
cell to which an acknowledgment is to be sent. 

secondary mode. An attribute of a point-to-point line 
station that defines the local node as the secondary 
Series/ 1 . Contrast with primary mode. 

secondary transaction identifier. A field of a transaction, 
whose meaning is defined by the program that processes 
the transaction. It may, for example, be the identifier of a 
transaction to be sent as an acknowledgment. 

SEND E. The instruction that sends an error message to 
the Communications Facility system log. 



REV (reverse chaining). The X.25 faciUty used to request 
that the cost of a communications session be charged to 
the called data terminal equipment. 

reverse charging (REV). The X.25 facility used to request 
that the cost of a communications session be charged to 
the called data terminal equipment. 

RMU. The transaction identifier associated with the 
Communications Facility program $.RMU. 



SEND L. The instruction that sends an informational 
message to the Communications Facility system log. 

SEND M. The instruction that sends a data message 
from a Communications Facility buffer. 

SEND S. The instruction that sends a status message 
from an EDX text area. See also status message. 
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SEND SM. The instruction tliat sends a status message 
from a Communications Facility buffer. 

Series/1 -PC Connect. A combination of Series/ 1 -PC 
Connect Attachment and software support for Series/ 1 
and PC. This makes some of the resources of Series/ 1 
available to PCs in a LAN. 

Series/ 1 -PC Connect Attachment. This hardware feature 
includes a Series/ 1 -PC Connect Attachment card, which 
installs in the Series/ 1 ; a PC extender card, which installs 
in the PC; and a 20-foot cable which connects the two 
cards. 

Series/ 1 -PC Connect Attachment microcode patch 
($PCCROn). The data set that contains patches to the 
Series/ 1 -PC Connect Attachment microcode, n is the EC 
level. 

set $.CFD storage utility ($.SETSTG). The utility 
program that changes the size of the message buffer pool 
and the file control block pool in $.CFD. 

SET CFBUF. The CP command that sets the warning 
level and the class 2 usage level of the message buffer pool 
(CFBUF). 

SET LOG. The CP command that assigns a log device or 
station for system log messages. 

SNA character string (SCS). A character string composed 
of EBCDIC controls, optionally intermixed with end-user 
data, that is carried within a request/response unit. 

SNA logical unit station. A station that represents an SNA 
logical unit (a terminal or a printer) in a Communications 
Facility configuration. 

SNA physical unit station. A station that represents an 
SNA physical unit in a Conununications Facility 
configuration. 

SNA prompt screen (panel). An optional menu put out by 
SNA logical units that prompts the terminal operator to 
log on to a host SNA appUcation. 

ST. (1) The CP command that displays message statistics 
and Local Communications Controller hardware statistics. 
(2) The work session controller command that sets the 
transaction identifiers of the transactions that are to be 
sent when a PF key on a static screen terminal is pressed 
after a WK command. 

started station. A station that is represented by a station 
block in S$POOL. 

static partition. An EDX partition in which the system 
maps all user and common areas for I/O at initialization 
time. 

station. A named unit of hardware or software managed 
by the Communications Facility. 



station address. The last two characters of a station's 
network address. They uniquely identify the station 
within the node. 

station block. A control block in S$POOL that contains 
information about a started station. 

station name. A 1- to 8-character alphanumeric value that 
uniquely identifies each station in a node. 

station subtype. An attribute of a station that further 
defines its type; for example, a device-type station may 
have a subtype such as 3101, 4978, or printer. 

station type. An attribute of a station that specifies its 
type (for example, line, device, terminal, user, or message 
station). 

status message. A message sent with a SEND S or SEND 
SM command that results in a unique return code (+6) 
when it is received. A status message is used to (1) tell a 
station to stop or halt. (2) send X.25 control messages 
between the X.25 I/O control program and applications 
Unked (alternate or direct) to a STD+ circuit station. 

STOP mode. The attribute of a circuit station that causes 
the I/O control program to stop the station when a call is 
cleared for a switched virtual circuit whose contact type is 
INIT. Contrast with RETRY mod&. 

stopped station. A station, represented by a station block 
in S$POOL, for which the flow of messages has been 
temporarily stopped. Messages sent to a stopped station 
are undeliverable. 

subchannel. A device address supported under loaded 
microcode control of Local Communications Controller or 
Series/ 1 -PC Connect Attachment. It is used to receive or 
transmit control or data messages. 

subtype, station. An attribute of a station that further 
defines its type; for example, a device-type station may 
have a subtype such as 3101, 4978, or printer. 

SVC (switched virtual circuit). A dynamically-estabUshed 
connection between two pieces of data terminal equipment 
(DTE). The switched virtual circuit is the packet network 
equivalent of a switched or dial-up line. In the 
Communications FaciUty, SVC circuit stations represent 
switched virtual circuits. 

switched virtual circuit (SVC). A dynamically-estabUshed 
connection between two pieces of data terminal equipment 
(DTE). The switched virtual circuit is the packet network 
equivalent of a switched or dial-up line. In the 
Communications FaciUty, SVC circuit stations represent 
switched virtual circuits. 

system initialization data set ($.SYSIPL). The data set 
containing CP commands that are to be executed when the 
Communications FaciUty is loaded. 
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system station. The station block, named $.DISP, that 
represents the Communications Facility control program. 

system storage pod (S$POOL). A workspace pool in the 
EDX supervisor, used by the Communications Facility for 
station blocks and work areas. 

tenninal, CMnmunlcatkHis Facility. A device defined to the 
Communications Facility, controlled by an I/O omtiol 
program, and accessed from a program through SEND and 
RECEIVE instructions. 

tenninal, EDX. A terminal defined to the EDX operating 
system and used to perform EDX system functions. 

terminal, work session contnrfler. A terminal managed by 
the work session controller and accessed from an 
application program by means of work session controller 
transactions. 

terminal statitm. A station that represents a 3270 control 
unit, display, or printer attached to a Series/1, or a station 
block used to emulate a 3270 control unit, diq>lay, or 
printer in a Communications Facility configuration. 

text mode. An attribute of a terminal or device station 
that causes lowercase data to be transferred without 
modification. Contrast with non-display mode. 



four types of program, creating a station, and/or sending 
the transaction message to the station. 

transparent mode. A mode of BSC transmission that 
allows any bit pattern to be transmitted as data. 

type, line. The combination of station type and station 
subtype for a communication line. Line type indicates 
which I/O control program (such as point-to-point or 
3270 control) is to control a particular line. 

type, message. An attribute of a message that indicates 
whether it is a data, command, log, transaction, or status 
message. 

type, station. An attribute of a station that specifies its 
type (for example, line, device, terminal, user, or message 
station). 

type, transactiML A 2-character indicator of the actions 
that occur when a transaction is entered: loading one of 
four types of program, creating a station, and/or sending 
the transaction message to the station. 

UBRETRY mode. The attribute of an SNA LU station 
that causes the I/O control program to attempt to rebind a 
session that was terminated by the host. Contrast with 
UBSTOPmode. 










I'lll (transaction identifier). The 4-character name of a 
transaction. 

TID statement A statement in $.SYSPD that identifies a 
transaction to be processed in the local cell. 

transactimL A special-format, user-defined message, 
routed through the Communications Facility network by 
the program dispatcher and processed at its destination by 
a specific transaction-processing program. 

transaction UattiSier (TID). The 4-character name of a 
transaction. 

transaction identifier (TID) table. The table that defines 
the transactions to be processed in the local cell. It 
contains, for each transaction, its identifier, its attributes, 
and the name and attributes of its associated programs. 

transacticm message. A message, the content of wiaich is a 
transaction. 

transaction-processing program. A program designed to 
process transactions. The program dispatcher controls 
loading and execution of transaction-processing programs 
as it receives transactions. 

transaction table. Synonymous with transaction identifier 
(TID) table. 

transactimi type. A 2-character indicator of the actions 
that occur when a transaction is entered: loading one of 



UBSTOP mode. The attribute of an SNA LU station that 
causes the I/O control program to stop the station when 
the host terminates a session. Contrast with UBRETRY 
mode. 

undeliverable message. A message that caimot be 
delivered because its destination station is stopped or is 
unknown to the message dispatcher. 

UP. The PD command that specifies whether or not the 
program dispatcher is to load program $.UPxxxx when it 
receives the undefined transaction xxxx. 

usage dass. The class designation of a station that 
determines what level of CFBUF usage will suspend the 
execution of SEND instructions from the station. 

usage leveL The amount (in percentage) of the 
Communications Facility message buffer pool (CHFBUF) 
in use. 

user PC. Other PCs in the LAN that are linked to the 
gateway PC. They share the resources of Series/ 1 
through the gateway PC. 

usca- statimL A station that represents a user or system 
program in a Communications Facility configuration. 

vector station. A station block that represents a remote 
station in a multinode Communications Fadlity 
configuration. 

virtual caSL A temporary logical connection between two 
pieces of data terminal equipment. Virtual calls are placed 
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through switched virtual circuits. See also switched virtual 
circuit. 

Tirtual circuit A logical connection established between 
two pieces of data terminal equipment. It can be 
permanent — defined when you subscribe to your network 
port— or it can be switched— dynamically established 
when a call is placed. The Communications Facility 
manages stations that represent these circmts; XHCS 
manages the circuits. See also switched virtual circuit and 
permanent virtual circuit. 

▼diume protection utility ($.PDBSTS). The utility program 
that allows a user to gain exclusive control of a disk 
volume directory in a remote Series/ 1 before loading a 
program that will update that directory. 

Ttrfume station. A station that represents emulated PC 
disks which reside on a Series/ 1 volume. 

warning processor. A task in $.CF that sends an error 
message to the system log when use of the message buffer 
pool (CFBUF) exceeds its warning level 

window. ( 1 ) The number of data packets a DTE or DCE 
can send across a logical channel before waiting for 
authorization to send another data packet. It is the main 
mechanism for pacing the flow of X.25 packets across an 
X.2S network. In the Communications Facility, window is 
defined in the line or circuit station definition. (2) In 
$.PAN£L, the area on the screen that can be seen one 
time when defining a 3270 panel. 

w(»k session c<»troDer ($.WSC). The part of the 
Communications Facility that allows an application 
program to communicate with multiple EDX devices 
attached to any Series/ 1 in the network. 

wOTk session c<Mitr(rfIer data set ($.WSCIMG). The data 
set containing images that can be displayed through the 
work session controller and members used to save data for 
transaction-processing programs. 

w<»l session ccmtrtdler sample program ($.WSM£NU). 
The program that can be used to start a session between 
an EDX terminal and work session controller application 
programs. 

work sessi<» contn^er tenninaL A terminal managed by 
the work session controller and accessed from an 
application program by means of work session controller 
transactions. 

woriu|Mce po<ri. An area of processor storage from which 
the Communications Facility programs allocate buffers 
and work areas. The pool includes information used to 
control the allocation of elements in the pool. 

WSC. (1) The transaction identifier associated with the 
Communications Facility program $.WSC. (2) The 
command that starts a work session controller terminal. 



X.25 data set The data set containing two-digit call IDs 
and their associated X.2S network addresses used during 
call establishment for switched virtual circuits. As 
shipped, it contains 10 records of /*. 

X.25 header. A header that precedes an X.2S control or 
data message. It identifies what type of message, control 
or data, is contained in the message. This header is 2 bytes 
long in the Communications Facility Version 2.0. 

X.25 network. A packet^switching data network that 
adheres to the standards defined by the CCITT 
Recommendation X.25. 

X.25 network address. A field of up to IS binary-coded 
decimal (BCD) digits that identifies the DTE to which a 
call is directed or from which a call originated. The 
Communications Facility provides a data set, $.SYSX2S, 
in which the user may relate this address to a two-digit call 

m. 

XHCS. The IBM Series/] Event Driven Executive 
X.2S/HDLC Communications Support licensed program 
(Program Number 5719-HD2). XHCS allows an 
application program, such as the Communications Facility, 
to communicate with remote applications through an 
HDLC cooununications link using X.2S packet level 
procedures. 

XOFF mode. An attribute of a point-to-point line station 
that causes data for that line to be written in 
nontransparent mode. Contrast with XON mode. 

XON mode. An attribute of a point-to-point line station 
that causes data for that line to be written in transparent 
mode. ConXxzsXvnih XOFF mode. 

3101. A term used to represent 3101 terminals (models 
12, 13, 22, and 23); 3161, 3163, or 3164 terminals in 
3101 emulation mode; and IBM Personal Computers 
running in 3 101 emulation mode as if they were 3277 
model 2 terminals. 

3270 cmitrd ($.IO0AC0). The input/output control 
program that controls 3270 displays and printers attached 
to the Series/ 1. 

3270 emulatitm. The facility that allows a host processor 
to communicate with Series/ 1 as if it were communicating 
with a 3270 system; also, the input/output control 
program that provides 3270 emulation over a BSC line 
($.IO0AE0). 

3270 mode. An attribute of a printer device station that 
causes data sent to it to be interpreted as a 3270 data 
stream. Contrast with SCS mode. 

3270 panel utility ($.PNLUT1). The utility program that 
prints the descriptions of panels created by the $.PANEL 
program. 
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3270 pass-through. In the Communications Facility, the 4978/printer data set ($.SYSPRT). The data set 

facility that allows users of Series/ 1 and 3270 devices on containing image and control store loads for 4978 

the Series/ 1 to communicate with host applications terminals and members used to support printers as 

without any additional application programs in the formatted devices. 
Series/ 1. The devices on the Series/ 1 appear as 3270 
devices to the host application. 
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input operations 118 
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operation 118 
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overview 23 
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data set requirements 137 

EDX requirements 137 

hardware requirements 137 
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linking stations 137 

operation 138 

output to terminals 147 
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station definitions 137 
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3270 functions supported 140 

4978 keyboard 140 

4980 keyboard 143 
$.100674 (printer lOCP) 

buffer requirements 229 

buffered printer support 151 
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hardware requirements 149 
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3270 data stream 152 
printer errors 154 
printer operation 151 
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storage requirements 221 
unbuffered printer support 151 
3270 functions supported 151 
3270 status messages 154 
.100680 (7485 terminal lOCP) 
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buffer requirements 229 
changing keyboard functions 162 
dual case support 162 
EDX requirements 156 
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hardware requirements 155 
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key functions 160 
keyboard 159 
lowercase support 162 
monocase support 162 
multifunction attachment 155 
multiple 7485s 156 
operation 157 
output to terminals 164 
overrun considerations 162 
overview 21 

program name requirements 156 
station definitions 156 
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communicating with volume station 47 
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EDX requirements 165 
hardware requirements 165 
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write 166 
operation 166 
overview 21 
PC requirements 165 
receiving messages 166 
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EDX requirements 169 
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logon parameter definitions 171 

non-remove mode 176 

operation 172 
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printer operation 

record mode input 

record mode output 
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restrictions 178 
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UBRETRY mode 73 
155 UBSTOP mode 73 
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changing 185 
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$.PANEL (panel design aid) 
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overview 41 
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3270 data stream support 43 
$.PD (program dispatcher) 

binary data transactions 30 
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defined 454, 458 

high-speed loader 32 

loading 

programs 234 
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overview 25 
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program management 31 
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shutting down 36 
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station definitions 34 

storage requirements 22 1 , 23 1 
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$.PD<IO> 

defined 454 

use of 39 
$.PDBSTS (volume protection utility) 
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overview 42 
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defined 454, 463 

use of 39 
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defined 454, 466 

storage requirement 23 1 
i.RMU (remote management utility) 

See also host management utility 
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storage requirement 23 1 
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description 182 

use by 4978/4980 data stream lOCP 137 
i.RPQISO 
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description 182 

use by 4978/4980 data stream lOCP 137 
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defined 454, 464 
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description 181 
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creating 264 

defined 454, 460 

description 183 
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residence requirement 183 

sample, BSC multipoint with transactions 345 

sample, BSC point-to-point with transactions 368 
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transactions 357 
).SYSMSG (message data set) 

defined 454, 460 

description 180 

residence requirement 180 
5.SYSNET (network configuration data set) 

defined 454, 461 

deleting entries from 179 

description 179 
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overview 3 

residence requirement 179 
6.SYSPD (program dispatcher data set) 

contents 187 

creating 187, 264 

defined 454, 462 
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description 183 

purpose 25 
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sample, BSC multipoint with transactions 345 

sample, BSC point-to-point with transactions 368 

sample, Local Communications Controller with 
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S.SYSPNL (panel data set) 

defined 454, 461 

description 182 
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$.SYSPRT (printer data set) 
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description 181, 182 

use by printer lOCP 1 49 

use by 4978/4980 data stream lOCP 1 37 
$.SYSX25 (X.25 call ID data set) 

contents 184 

creating 184, 265 

defined 454, 466 

description 184 
$.UT1 (diagnostic aid utility) 
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overview 42 

use to monitor usage of CFBUF 222, 223 

use to monitor usage of S$POOL 222 
$.UT2 (message queue management utility) 

defined 454, 461 

overview 42 

storage requirements 232 
$. WASTE (undeliverable message queue) 
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for messages 12 

for transactions 34 
$.WSC (work session controller) 

$.WSMENU 42 

defined 454, 466 

images 
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overview 40 
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storage requirement 221 
$.WSCIMG (work session controller data set) 

defined 454, 466 

description 185 

residence requirement 185 
$.WSCUT1 (image library management utiUty) 

defined 454, 459 

overview 42 

use to transfer images to $.WSCIMG 1 85 
$.WSMENU (work session controller sample program) 

defined 454, 466 

overview 42 
$COPYUTl utility 

to copy distribution diskettes to disk 254 

to initialize multiple data sets 209 
$DISKUT1 utility 

to allocate Communications Facility data sets 179 

to allocate work data sets 255 
$DISKUT2 utility 

to set $.CFS dynamic storage size 223 
$DIUTIL UtiUty 

to initiaUze data sets 179 
$EDXASM assembler 

overlays 213 

user-written programs 43 
$EDXPEF (supervisor definition data set) 

assembling 262 
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editing 255 
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example 255 

sample, BSC connection to a host 276 

sample, BSC multipoint between Series/ Is 341 

sample, BSC point-to-point between Series/ Is 330 

sample, BSC point-to-point with transactions 351 

sample, channel attach connection to a host 281 

sample, HDLC point-to-point between 
Series/Is 390 

sample, HDLC with transactions 405 

sample, LAN with Series/ 1 -PC Connect Attachment 
and EDX Secondary SNAl Connection 423 

sample. Local Communications Controller 319 

sample. Local Communications Controller with 
transactions 372 

sample, PC Connect with inter-LAN services 433 

sample, SNAl connection to a host 289 

sample, SNA2 connection to a host 300 
$EDXL (assembler control data set) 

editing 261 
$EDXLINK 

to link-edit multimodule programs 446 

to link-edit the supervisor 262 
$FSEDIT editor 

to create S$POOL 258 

to edit $EDXDEF 255 

to edit $EDXL 261 

to edit $LNKCNTL 259 
$IMAGE utility 

building work session controller images 43 
$INITDSK utility 

to rewrite IPL text 262 
$INITIAL 

defined 455 
$L (load command) 

program check when using 234 

use to load Communications Facility programs 234 
$LNKCNTL (supervisor link control data set) 
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editing 259 
$PCCROn (PC Connect microcode patch data set) 
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installing 254 
$PREFIND utility 
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$STORAGE 

defined 455 
$S1ASM assembler 

user-written programs 43 
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creating DDMs 91 
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$4978CSO 
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description 182 
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use by 4978/4980 data stream lOCP 138 
$4978ISO 

defined 455 

description 182 
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use by 4978/4980 data stream lOCP 138 
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use by 4978/4980 data stream lOCP 137 
$4980ISA 
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overview 3 

use by 4978/4980 data stream lOCP 137 
$4980180 

defined 455 

description 182 
$4980R0A 

defined 455 

description 182 
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use by 4978/4980 data stream lOCP 137 
$4980R01 
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use by 4978/4980 data stream lOCP 137 
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buffer requirements 227 
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changing keyboard functions 133 

dual case support 132 

EDX requirements 124 

feature programmable communications adapter 121 

hardware requirements 121 
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input from terminals 126 

key functions 130 

keyboard 127 
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lowercase support 132 

monocase support 132 

multifunction attachment 121 

multiple 3101s 124 
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operation 125 
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overrun considerations 133 
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7485 lOCP 156 
address, station 
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overview 49 
alias station 

defined 455 

defining 65 

description 48 

storage requirement 221 
ALP mode 

defined 455 

overview 74 
alpha/numeric attribute 

supported on 3101 126 

supported on 7485 158 
alphanumeric mode 

defined 455 

overview 74 
alternate link vector 

defined 455 

use of 33 
ASCII/EBCDIC translation tables 

changing for 3 101s 135 
assembler 

considerations, user programs 43 

control data set, editing 261 

maintaining the Communications Facility 445 

overlay programs 25 1 
assembling 

supervisor definition data set 262 

system storage pool 262 
attachment 

Series/ 1 -PC Connect Attachment 247 
attributes 

supported on 3 1 1 1 26 

supported on 4978 data stream 140 

supported on 7485 158 
automatic skip attribute 

supported on 3101 126 

supported on 4978 data stream 140 

supported on 7485 158 
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basic material 

diskette contents 25 1 

transferring to disk 254 
basic mode 

channel attach lOCP 105 
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overview 73 

point-to-point lOCP 118 

3270 control lOCP 99 

3270 emulation lOCP 1 1 1 
BCUG (bilateral closed user group) facility 

defined 455 

defining 59 
between brackets state 

SNA 173 
bilateral closed user group (BCUG) facility 
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defining 59 
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conversion, transactions 30 
binary output 

3270 control lOCP 100 
3270 emulation lOCP 1 1 3 
binary synchronous communication (BSC) 
defining lines to EDX 257 
point-to-point lOCP 1 1 7 
sample configurations 

connection to a host 272 
multipoint with transactions 342 
multipoint. Series/ 1 -to-Series/ 1 332 
point-to-point. Series/ 1 -to-Series/ 1 3 22 
3270 control lOCP 97 
3270 emulation lOCP 1 09 
BIND parameters 

SNA 173 
bold type 

syntax notation for $.SYSPD definition 

statements 188 
syntax notation for supervisor definition 
instructions 235 
braces 

syntax notation for $.SYSPD definition 

statements 188 
syntax notation for supervisor definition 
instructions 235 
bracket 

SNA 173 

syntax notation for $.SYSPD definition 

statements 188 
syntax notation for supervisor definition 
instructions 235 
BRB (buffer reference block) 
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instruction to define 241 
storage requirements 219 
BRINDEX table 

changing functions of 3 1 1 keys 133 
changing functions of 7485 keys 162 
broadcast 

transactions 29 
BSC (binary synchronous communication) 
defining lines to EDX 257 
point-to-point lOCP 1 17 
sample configurations 

connection to a host 272 
multipoint with transactions 342 
multipoint, Series/ 1 -to-Series/ 1 332 
point-to-point. Series/ 1 -to-Series/ 1 322 
3270 control lOCP 97 
3270 emulation lOCP 109 
BSC point-to-point lOCP ($.IO0A20) 
basic mode input 118 
basic mode output 119 
buffer requirements 227 
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hardware requirements 117 
input operations 118 



/f""^\ 



474 Communications Facility Design and Installation Guide 






linking stations 118 

multiple-block data 119 

operation 118 

output operations 119 

overview 23 

record mode input 118 

record mode output 119 

restrictions 119 

single-block data 119 

station definitions 118 

strapping requirements 117 
BSCLINE statement 

defining lines to EDX 257 

3270 control lOCP 98 

3270 emulation lOCP 1 10 
buffer control orders 

supported on 3101 126 

supported on 4978 data stream 140 

supported on 7485 158 
buffer reference block (BRB) 

defined 455 

instruction to define 241 

storage requirements 219 
buffer, Communications Facility 

channel attach lOCP 226 

defined 455, 456 

header 

defined 455, 459 

Local Communications Controller lOCP 224 

PC Connect disk-server lOCP 230 

PC Connect lOCP 223 

point-to-point lOCP 227 

pool 

lOCPs 71 

storage requirements 219 

Series/ 1 -to-Series/ 1 BSC lOCP 227 

SNA lOCP 230 

X.25 lOCP 225 

3101 lOCP 227 

3270 control lOCP 226 

3270 emulation lOCP 226 

4973/4974/4975/5224/5225/5262 printer 
lOCP 229 

4978/4980 data stream lOCP 228 

7485 lOCP 229 
buffered device 
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printer lOCP 151 

3101IOCP 125 

7485 lOCP 157 







call accept control message 

defined 455 
call connected control message 
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call ID 

defined 455 
call ID data set, X.25 ($.SYSX25) 
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creating 184, 265 

defined 454, 466 

description 184 
call request control message 

defined 455 
card reader 

not supported on 3101 126 

not supported on 4978 data stream 

not supported on 7485 158 
cause code 

defined 455 
CCITT 

defined 456 
cell 

defined 456 

definition in $.SYSPD 188 

entry in path table 26 

remote 

defined 463 

specification in transactions 25 

statement to define 191 
cell identifier 

in transaction format 26 

primary 

specification 26 

secondary 

specification 26 
CELL statement 

defined 456 

example 191 

operands 191 

syntax 191 
central node configuration 

managing 44 
CFBUF (message buffer pool) 

changing size 42 

current usage 18 

defined 456, 460 

overview 4 

storage requirements 222 

usage class 17 

usage level 17 

warning level 18 
CFTERM 

defined 456 

defining terminals to EDX 256 

defining 3101s 124 

defining 7485s 156 

format 249 
channel attach lOCP ($.IO0AD0) 

basic mode 104, 105, 106 

binary output 113 

buffer requirements 226 
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EDX requirements 103 

hardware requirements 103 

input from terminals 99 
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operation 104 

overview 19 
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printer operation 105 

record mode 105 

restrictions 106 

station definitions 103 
circuit station 

configuration worksheet 55 

defined 456 

defining 57, 91 

establishing communication 92 

linking 91 

starting 92 
clear confirmation control message 

defined 456 
clear indication control message 

defined 456 
CLEAR keyboard function 

supported on 3101 126 

supported on 4978 data stream 140 

supported on 7485 158 
clear request control message 

defined 456 
closed user group (CUG) facility 

defined 456 

defining 59 
COBOL 

use of user-written programs 43 
command message 

defined 456 

overview 13 
command-processing program 

defined 456 
command processor 

Communications Manager commands 15 

defined 456 

overview 13 

PD commands 14 
command processor (CP) commands 

defined 456 

entering 15, 100 

in $.SYSPD 187 

overview 13 

summary 14 
commands 

entering 15 

overview 1 3 

summary 14 
common area 

storage requirements 220 
Communications Facility 

components 

description 1 
sizes 216 

configuration 
defined 456 

publications list v 

terminal 

defined 456, 465 
Communications Facility/Host licensed program 

defined 456 

publications v 

requirements for 177 

use of 37 
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command processing 15 
node assignment 
publications vi 

storage requirements for communication with 23 1 
compacting 

EDX supervisor 263 
components. Communications Facility 
description 1 
sizes 216 
configuration 

worksheets 49 
configuration processor ($.CONFIG) 
defined 453, 456 
overview 41 
configurations, sample 

BSC connection to a host 272 

BSC multipoint with transactions 342 

BSC multipoint, between Series/ Is 332 

BSC point-to-point with transactions 366 

BSC point-to-point, between Series/Is 322 

channel attach connection to a host 278 

HDLC connection through an X.25 network 392 

HDLC point-to-point, between Series/ Is 382 

LAN with Series/ 1 -PC Connect Attachment and 

EDX Secondary SNAl Connection 418 
Local Communications Controller 310 
Local Communications Controller with 

transactions 355 
multiple Local Communications Controller and BSC 

connections 374 
PC Connect with inter-LAN services 432 
SNAl connection to a host 284 
SNA2 connection to a host 296 
X.25 connection between a Series/ 1 and DTEs 406 
control and image stores 
in$.SYSPRT 181 
use by printer lOCP 149 
use by 4978/4980 data stream lOCP 138 
control blocks 
station 

creating 1 1 
creation 1 1 
defined 464 
for transactions 31,33 
overview 4 

work session controller 40, 43 
control message link 

purpose 89 
control messages, X.25 
call accept 

defined 455 
call connected 

defined 455 
call request 

defined 455 
clear confirmation 
defined 456 
clear indication 

defined 456 
clear request 

defined 456 
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defined 456 

error indication 
defined 458 

incoming call 
defined 459 

interrupt confirmation 
defined 459 

passthrough 

defined 461 

purpose 89 

reset confirmation 
defined 463 

reset indication 
defined 463 
control packet, X.25 

purpose 89 
control program ($.CF) 

defined 453, 456 

partition 213, 222 

storage requirements 221,222 
control store, $RPQCSO 

defined 454 

description 1 82 

use by 4978/4980 data stream lOCP 137 
control store, $4978CSO 

defined 455 

description 182 

use by printer lOCP 1 49 

use by 4978/4980 data stream IOC? 138 
control store, $4980CSA 

defined 455 

description 182 

overview 3 

use by 4978/4980 data stream lOCP 137 
control store, $4980CS0 

defined 455 

description 182 

use by 4978/4980 data stream lOCP 137 
control, 3270, lOCP ($.IO0AC0) 

basic mode input 99 

basic mode output 100 

binary output 100 

buffer requirements 226 

defined 453, 456, 466 

description 97 

EDX requirements 98 

entering commands 100 

hardware requirements 98 

input from terminals 99 

linking stations 98 

operation 98 

output to terminals 100 

overview 19, 21 

record mode input 99 

record mode output 101 

remote IPL 100 

restrictions 101 

station definitions 98 

strapping requirements 98 
copy command code 

not supported on 3101 126 

not supported on 4978 data stream 140 

not supported on 7485 158 



copymg 

distribution diskettes to disk 254 
CP (command processor) commands 

defined 456 

entering 15, 100 

in $.SYSPD 187 

overview 13 

summary 14 
CP F command 

defined 458 
CP FILE command 

defined 459 
CSLCPOVl 

including in $LNKCNTL 260 
CSLCPOV2 

including in $LNKCNTL 260 
CSPDIO 

defined 456 

use of 39 
CSXINIT 

required for installation 259 

use of 220 
CSXRDINT 

required for installation 260 

use of 220 
CSXSYS system tables 

storage requirement 220 
CTZOIA 

in $LNKCTNL 260 
CTZOII 

in $LNKCNTL 260 

required for installation 257 
CUG (closed user group) facility 

defined 456 

defining 59 
cursor movement keyboard function 

supported on 3101 126 

supported on 4978 data stream 140 

supported on 7485 158 
CURSR SEL keyboard function 

not supported on 3 1 1 1 26 

not supported on 4978 data stream 140 

not supported on 7485 158 
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D-bit (delivery confirmation bit) 

defined 457 

restrictions on support 96 
data circuit-terminating equipment (DCE) 

defined 456, 457 

device type 56 
data message 

defined 457 

overview 13 
data mode 

non-display 73 

text 73 
data move 

instruction 5 
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See also names of specific data sets 

allocating 179 

initializing for disk queuing 209 

naming conventions, distribution diskettes 25 1 

overview 3 

prefinding 32 

transferring to disk 254 
data stream, 3270 

exchanging in a program 43 

instructions to create 5 

overview 21 

page formatting 152 

RPQ 

defined 457 
overview 21 

transactions 29 
data terminal equipment (DTE) 

defined 457 

device type 56 

link and packet definitions 90 
Datamaster 

lOCP functions 117 
DCE (data circuit-terminating equipment) 

defined 456, 457 

device type 56 
DDM (device descriptor module), XHCS 

defined 457 

definitions 91 

requirement for 90 
DDSK-30 (Model 30D Integrated Disk Storage Unit) 

defined 457 

remote IPL address 38 
DDSK-60 (Model 60D Integrated Disk Storage Unit) 

defined 457 

remote IPL address 38 
deadband 

disk-queue data set 209 
DEF, CP command 

defined 457 
default 

modes, lOCP 71 
DEFINE BRB instruction 

defined 457 

format 241 
DEFINE BUFFERPOOL instruction 

defined 457 

format 239 
DEFINE DEVICE instruction 

defined 457 

syntax 243 

to define remote disks 258 
DEFINE POOL instruction 

defined 457 

format 239 
define printout format write control character 

not supported on 3 1 1 1 26 

not supported on 4978 data stream 140 

not supported on 7485 158 
DEFINE VOLUME instruction 

defined 457 

syntax 245 



to define remote disks 258 
DEFINE WORK instruction 

defined 457 

format 239 
defining 

alias stations 65 

buffer reference block 241 

device stations 62 

devices to EDX 255 

line stations 56 

logical unit stations 60 

message stations 63 

node stations 61 

non-EDX 3101 on multifunction attachment 249 

non-EDX 7485 on multifunction attachment 249 

PC Connect 247 

physical unit stations 59 

remote disk access 243 

remote disk volume 245 

remote stations 64 

stations 45 

system storage pool 239 

terminal stations 64 

user stations 63 

volume stations 63 

workspace pool 239 

3101s 124 

7485s 156 
definition data set ($EDXDEF) 

assembling 262 

defined 454 

editing 255 

example 255 

sample, BSC connection to a host 276 

sample, BSC multipoint between Series/ Is 341 

sample, BSC point-to-point between Series/ Is 330 

sample, BSC point-to-point with transactions 35 1 

sample, channel attach connection to a host 281 

sample, HDLC point-to-point between 
Series/ Is 390 

sample, HDLC with transactions 405 

sample, LAN with Series/ 1 -PC Connect Attachment 
and EDX Secondary SNAl Connection 423 

sample, Local Communications Controller 319 

sample, Local Communications Controller with 
transactions 372 

sample, PC Connect with inter-LAN services 433 

sample, SNAl connection to a host 289 

sample, SNA2 connection to a host 300 
DEL keyboard function 

supported on 3101 126 

supported on 4978 data stream 140 

supported on 7485 158 
delivery confirmation bit (D-bit) 

defined 457 

restrictions on support 96 
device 

adding 23 

configuration worksheet 52 

defined 457 

dependent information in messages 73 

descriptor module (DDM), XHCS 
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definitions 9 1 
requirement for 90 

point-to-point 117 

printer lOCP 149 

Series/ 1 115 

station 

defining 62 
description 46 
link requirement 65 
storage requirement 221 

type 

defined 457 

2770-like 117 

3101s lOCP 121 

3270 emulation lOCP 109 

3270 lOCPs 97 

3741-Uke 117 

4978/4980 data stream lOCP 137 
device descriptor module (DDM), XHCS 

defined 457 

definitions 91 

requirement for 90 
diagnostic aid utility ($.UT1) 

defined 454 

overview 42 

use to monitor usage of CFBUF 222, 223 

use to monitor usage of S$POOL 222 
direct link vector 

changing 12 

defined 458 

guidelines 65 
disk queue 

defined 458 

overview 4 

usage 1 1 
disk-queue data set 

allocating 209 

assigning to stations 210 

creating 207 

defined 458 

displaying information about 211 

initializing 209, 264 

purpose 185 

size 207 

use of 209 

worksheet 208 
disk-queue data set initialization utility ($.DSINIT) 

defined 453, 458 

overview 41 

use of 209 
disk, remote 

access 243 

defined 458, 463 

EDX definition 243 

multinode configuration management 44 

on-line message. Local Communications 
Controller 86 

use of 39 

volume definition 245 
diskettes, distribution 

copying to disk 254 

directories 251 
dispatcher, message 
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message header 6 

message routing 6 

overview 6 

station 48 

versions 6 
dispatcher, program ($.PD) 

binary data transactions 30 

creating stations 31 

defined 454, 458 

high-speed loader 32 

loading 

programs 234 

multinode configuration management 44 

overview 25 

prefinding data sets 32 

program management 31 

rerouting transactions 32 

shutting down 36 

starting stations 35 

station 25 

station definitions 34 

storage requirements 221, 231 

transaction testing 34 

transaction tracing 34 
Displaywriter 

lOCP functions 117 
distribution diskettes 

data set names 25 1 
DTE (data terminal equipment) 

defined 457 

device type 56 

Unk and packet definitions 90 
dual case 

on 3101 132 
DUP keyboard function 

supported on 3 1 1 1 26 

supported on 4978 data stream 140 

supported on 7485 158 
dynamic storage 

requirements 213, 231 
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EBCDIC/ASCII translation tables 
changing for 3 101s 135 

editing 

assembler control data set 261 
program dispatcher data set 187 
supervisor definition data set 255 
supervisor hnk control data set 259 

EDL language extensions 
defined 458, 460 
overview 4 

EDX (Event Driven Executive) 
publications list iv 
requirements 

channel attach lOCP 103 
defining 7485s 156 
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PC Connect disk-server lOCP 165 

PC Connect lOCP 77 

point-to-point lOCP 1 1 8 

printer lOCP 149 

Series/ 1 -to-Series/ 1 BSC lOCP 1 1 5 

SNA lOCP 169 

X.25 lOCP 90 

3101 lOCP 124 

3270 control lOCP 98 

3270 emulation lOCP 1 1 

4978/4980 data stream lOCP 137 
supervisor 

compacting 263 

link-editing 262 

maintaining 445 

partition 213 

rebuilding 262 

storage requirements 220 
system tables (EDXSYS) 220 
terminal 
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managing 40 
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defined 458 
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defining stations 171 
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EDX-SNA program 
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EDXSYS system tables 

storage requirement 220 
emulated PC disk control data set ($.DSPROF) 
contents 184 
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description 184 
emulated PC disk management utility ($.DSFORM) 
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messages to $.IO0CC8 167 
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used by $.I01CC8 167 
emulation, 3270, lOCP ($.IO0AE0) 
basic mode input 111 
basic mode output 113 
binary output 113 
buffer requirements 226 
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description 109 
EDX requirements 110 
hardware requirements 109 
linking stations 110 
messages from the host 111 
messages to the host 113 
operation 110 
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printer operation 112 
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record mode output 113 

restrictions 114 
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strapping requirements 109 
ENTER keyboard function 
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supported on 4978 data stream 140 

supported on 7485 158 
EQU statement 
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example 193 

operands 1 93 

syntax 193 
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defining 193 
erase all unprotected command code 

supported on 3101 126 

supported on 4978 data stream 140 

supported on 7485 158 
ERASE EOF keyboard function 

supported on 3 1 1 126 

supported on 4978 data stream 140 

supported on 7485 158 
ERASE INPUT keyboard function 

supported on 3101 126 

supported on 4978 data stream 140 

supported on 7485 158 
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supported on 4978 data stream 140 

supported on 7485 158 
erase/write alternate command code 

supported on 3101 126 

supported on 4978 data stream 140 

supported on 7485 158 
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supported on 3101 126 

supported on 4978 data stream 140 

supported on 7485 158 
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SNA 174 
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SNAIOCP 178 
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Event Driven Executive (EDX) 
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X.25 lOCP 90 
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3270 control lOCP 98 

3270 emulation lOCP 1 10 

4978/4980 data stream lOCP 
supervisor 

compacting 263 

link-editing 262 

maintaining 445 

partition 213 

rebuilding 262 

storage requirements 
system tables (EDXSYS) 
terminal 

defined 458, 465 

managing 40 
examples 

See also sample configurations 
$LNKCNTL data set 260 
CELL statement 191 
CFTERM instruction 249 
DEFINE BRB instruction 241 
DEFINE BUFFERPOOL instruction 
DEFINE DEVICE instruction 243 
DEFINE POOL instruction 239 
DEFINE VOLUME instruction 245 
DEFINE WORK instruction 239 
EQU statement 193 
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message flow within a node 7 
PATH statement 195 
PCC instruction 247 
preferred path 27 
RESERVE statement 197 
RTE statement 199 
supervisor definition data set 
TID statement 201 
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WSC transaction 43 
3270 data streams 43 
EXIODEV 
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fast select (FS) facility 

defined 458, 459 

defining 59 
fast select restricted (FSR) facility 

defined 458, 459 

defining 59 
FCB (file control block) 

changing size of pool 42 
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overview 4 
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7485 terminals 155 



42 



field formatting 

3270 instructions 5 
file control block (FCB) 
changing size of pool 
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controlUng 1 1 

LAN with Series/ 1-PC Connect Attachment and 

EDX Secondary SNA 1 Connection 418 
sample configuration 

BSC connection to a host 273 

BSC multipoint between Series/ Is 332 

BSC multipoint with transactions 342 

BSC point-to-point between Series/ Is 323 

BSC point-to-point with transactions 367 

channel attach connection to a host 278 
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Local Communications Controller with 

transactions 354 
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SNAl connection to a host 284 
SNA2 connection to a host 296 
within a node 6 
FM keyboard function 

supported on 3101 126 
supported on 4978 data stream 140 
supported on 7485 158 
formatted print operations 

printer lOCP 152,153 
FS (fast select) facility 
defined 458, 459 
defining 59 
FSR (fast select restricted) f acihty 
defined 458, 459 
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establishing communication 79 
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GET S instruction 
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explanation 38 
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point-to-point, Series/ 1 -to-Series/ 1 382 
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buffer 
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message 

defined 459, 460 
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purpose 89 
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high-level data link control (HDLC) lines 
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point-to-point. Series/ 1 -to-Series/ 1 382 
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use 31 
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supported on 3 1 1 1 26 

supported on 4978 data stream 140 

supported on 7485 158 
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TID statement for 204 
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input 

defined 459 
setting 12 

output 
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3270 emulation lOCP 1 1 1 
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See also remote management utility 
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image library management utility ($.WSCUT1) 
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use by 4978/4980 data stream lOCP 138 
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defined 455 
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initial program load (IPL) 
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3270 control 100 
initialization data set ($.SYS1PL) 

defined 454, 459 
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disk-queue data sets 209, 264 
ink jet printer 
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input 
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input/output control program (lOCP) 

See also names of specific lOCPs 

buffer requirements 7 1 
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modes of operation 7 1 
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shutting down 25 
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INS MODE keyboard function 
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supported on 7485 158 
insert cursor buffer control order 
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supported on 4978 data stream 140 

supported on 7485 158 
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message management 5 
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queue management 5 

station management 5 

storage management 5 

supervisor definition 
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overview 5 
syntax 235 
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lOCP (input/output control program) 
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shutting down 25 
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IPL (initial program load) 
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3270 control 100 
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TID statement for 203 
use of 37 
IPL transaction data set ($.SYSLCC) 
contents 38 
creating 264 
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sample, BSC point-to-point with transactions 368 
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K 



140 



keyboard functions 
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supported on 7485 158 
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LAN (local area network) 
defined 460 
description 23 
LAN with Series/ 1 -PC Connect Attachment and 

EDX Secondary SNAl Connection 418 
PC Connect disk-server lOCP 1 65 
PC Connect lOCP 77 
PC Connect with inter-LAN services 432 
language considerations 
user programs 43 
language extensions, EDL 
defined 458, 460 
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defining 58 
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point-to-point lOCP 1 1 7 
Series/ 1 -to-Series/ 1 BSC lOCP 115 
3270 control lOCP 97 
3270 emulation lOCP 109 
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type 
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configuration worksheet 53 
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editing 259 
link-editing 

multimodule programs 446 
the supervisor 262 
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requirement 84 
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loader, high-speed ($.HSL) 
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loading 
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CP start command 232 
EDX $L command 234 
program dispatcher 234 
programs 32 

program dispatcher 3 1 
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transaction-processing programs 32 
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PC Connect lOCP 77 
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control messages 84 
IPL request 86 
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nuU message 86 
off-Une notification 86 
on-line broadcast 85 
on-Une response 85 
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traffic control 86 
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operation 84 
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restrictions 86 
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log processor 
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overview 16 
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defining to the Communications Facility 60 

defining to the host 170 

description 46 
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4980 data stream IOC? 
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installing 265 



140 
143 



170 



M 



machine-readable material 
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how to assemble and link-edit programs 
mapped partition 
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MENU transaction 

TID statement for 204 
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basic mode transmission 73 
command 13 
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data 
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overview 13 
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error /log 13 
flow 
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3270 emulation 113 
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usage level 17 
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defined 454, 460 
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message dispatcher 
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disk storage 1 1 
overview 4 
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usage 1 1 
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overview 42 
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storage requirement 221 
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use by 4978/4980 data stream lOCP 137 
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lOCP 71 
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supported on 4978 data stream 140 
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7485 162 
move 

instruction 5 
multifunction attachment 

defining 124 

non-EDX3101 249 
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NON-D mode 
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NON-R mode 
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NUM mode 
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page formatting 

printer lOCP 152,153 
panel 
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supported on 7485 158 
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summary 15 
PD F command 

defined 458 
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purpose 90 
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message header 79 
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supported on 4978 data stream 140 

supported on 7485 158 
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defining to the host 170 

description 46 
80 storage requirement 221 
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basic mode output 119 
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linking stations 118 
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operation 118 
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record mode owtput 119 
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overlays and data sets 32 
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printer lOCP 151 

SNAIOCP 175 
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printer control order 
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supported on 4978 data stream 140 
supported on7485 158 
printer data set ($.SYSPRT) 
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use by printer lOCP 149 
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data set requirements 149 
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REC mode 
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3270 emulation 112,113 
receive state 
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defining 59 
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hardware 38 
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supported on 4978 data stream 140 
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REV (reverse charging) facility 
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defining 59 
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example 199 
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S$CFEQU 
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storage requirements 221 
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BSC connection to a host 272 
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printer operation 151 
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overview 75 
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specification 26 
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defining stations 171 

used by $.I014E8 169 
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defined 458 
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PU number 60 
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operation 116 

overview 21 
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shutting down 
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link requirement 65 
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parameters 171 
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description 46 
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printer operation 151 
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basic mode input 175 
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storage requirement 219 
start field buffer control order 
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assigning a disk queue 210 

block 
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defined 461, 464 







Index 493 



program dispatcher 35 
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Communications Facility working storage 219 

Communications Manager command processor 23 1 

component sizes 216 

disk-queued message utility 232 

EDX supervisor requirements 220 

lOCP buffers 223 

management 

instructions 5 
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multifunction attachment 220 
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panel utility 231 
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remote management utilities 23 1 

S$POOL 221 
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transaction scheduler 232 

work session controller 40 
storage resource block (SRB) 
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for 3101s 124 
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STORINIT (EDX unmapped storage management 
module) 

for 3101s 124 

for 7485s 156 
strapping requirements 

point-to-point 117 

Series/ 1 -to-Series/ 1 BSC 115 
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3101 on multifunction attachment 121 

3270 control 98 

3270 emulation 109 

7485 on feature programmable communications 
adapter 155 
subtype, station 
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assembling 262 
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editing 255 

example 255 

sample, BSC connection to a host 276 

sample, BSC multipoint between Series/ Is 341 
sample, BSC point-to-point between Series/ Is 330 
sample, BSC point-to-point with transactions 351 
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format 236 
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PCC 247 

syntax notation 235 
supervisor link control data set ($LNKCNTL) 
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rebuilding 262 
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defining 93 
switches 

3101 setup 121 
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syntax notation 
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supervisor definition instructions 235 
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overview 36 
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overview 5 
system log 
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system station ($.DISP) 

defined 453, 464 

description 48 

storage requirement 221 
system storage pool (S$POOL) 
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defined 463, 465 
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overview 4 
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overview 36 



,#"^x 



\ _ 1^ 



494 Communications Facility Design and Installation Guide 
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lOCP functions 117 
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buffer requirements 226 
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EDX requirements 103 
hardware requirements 103 
input from terminals 99 
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operation 104 
overview 19 

performance considerations 107 
printer operation 105 
record mode 105 
restrictions 106 
station definitions 103 
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configuration worksheet 54 
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defining 60 

defining to EDX-SNA 170 
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description 46 
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logon 

parameters 171 
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defining 59 

defining to EDX-SNA 1 70 
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description 46 

link requirement 65 
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prompt screen 

customizing for 8 1 00 DPPX 265 
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session states 173 
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basic mode output 176 
BIND parameters 173 
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operation 172 
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control instructions 5 
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3101 terminals 121 
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See also names of specific terminals 

Communications Facility 
defined 456, 465 

EDX 

defined 458, 465 

work session controller 
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adding to $EDXDEF 256 

defining printers 149 

defining 3101s 121 
terminal station 

defined 465 
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3101 terminals 121 
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not supported on 4978 data stream 140 
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TEX mode 

defined 465 
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defined 465 
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transactions 34 
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transaction 

See also names of specific transactions 
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controlling flow 33 
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format 25 
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IBM-supplied, TID statements for 204 
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defined 465 
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overview 13 
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rerouting 32 
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scheduling 37 

statement to define 201 

system 36 
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tracing 34 

type 

defined 465 

type codes 202 

undeliverable 33 
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overview 26 
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statement to define 201 
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modifying an entry 33 

reserving space in 197 
transaction-processing program 
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overview 13, 25 
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defined 465 
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defined 460, 465 

line 
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overview 13 
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UBSTOP mode 
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message 
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storage requirement 221 
user/message/alias 
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defined 455 
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volume 
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defined 454, 466 
overview 42 
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defined 466 
description 47 
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warning processor 
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usage 58 
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$.WSMENU 42 

defined 454, 466 
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overview 40 
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terminal 

defined 465 
storage requirement 221 
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defined 454, 466 

description 185 
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supported on7485 158 
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purpose 89 

use in receiving messages 94 
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defined 455 
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defined 455 
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defined 456 
clear request 

defined 456 
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defined 459 
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defined 459 
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DCE support 96 
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establishing communication 92 
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RETRY mode 74 
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purpose 90 
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XON mode 
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multifunction attachment 121 
multiple 3101s 124 
multiple 7485s 156 
operation 125 
output to terminals 134 
overrun considerations 133 
setup switches 121 
station definitions 124 
uppercase support 132 
3277 functions 126 
3270 

commands 
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